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the computer under normal, standard 
conditions. Getting the programs up 
and running should not present you 
with any difficulties, simply pul your 
disk in [he drive and enter (he 
command. 



LOAD 



progn 



Once the disk menu has loaded you 
will be able to start any of the 
programs simply be selecting the 
desired one from the list. It Is 
possible for some programs to alter 
the compulers memory so that you 
will not be able to LOAD programs 
from the menu correctly until you 
reset the machine. We therefore 
suggest that you turn your computer 
Off and then on again, before loading 
each program. 

HOW TO COPY CDU FILES 

You are welcome to make as many 
of your own copies of CDU 
M want, as long as 
is them on to other 
people, or worse, sell them for profit. 
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INSTRUCTIONS 



CAMBS 
PE1 7 4LE 

Telephone; 0480-495520 

Within eight weeks of publication 
date disks are replaced free. 

After eight weeks a replacement 
disk can be supplied from Proloscan 
charge of £1.00. Return 
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PROTOSCAN 
issue of CDU that y 
documentation will be supplied. 

Please use appropriate packaging, 
cardboard stiffener at least, when 
returning disk. Do not send back 
your magazine, only the disk please. 

NOTE: Do not send your disks back 
to the above address il its a program 
that does not appear to work. Only if 
the DI5K is faulty. Program faults 
should be sent to: BUG FINDERS, 
CDU, Alphavite Publications Ltd, 
Unit 20, Potters Lane, Kiln Farm. 
Milton Keynes, MK11 3HF. Thank 
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FEATURE 



If you have ever wanted to produce your 



n GEOS environment applications this utility 



package is just for you 



I have always found ih 
programmers talk aboul assemmy 
language whether it is on a C64 or 
Amiga, they usually make it out lo lie 
some sort oi mystical art that only the 
super brains of the computer world 
can grasp. My motto is: have a go; so 

programmer sound complex, it is only 
in the sense that it is sophisticated. 
Geoprogrammer is not designed 10 
teach you assembly language but it 
makes things a little easier. With il, 
BERKELEY SOFTWORKS have shown 

support in helping users and third 

application software operating within 
the Geos environment. But don't be 
mislead as Geoprogrammer will allow 
you to write your own stand alone 
programs which can be run 
completely independent of Ceos. 

Geoprogrammer is supplied in 
usual Berkeley packaging, consisting 
of a double sided disk and a 400 



,hen BRIAN SEDCEBEAR 



o the u 



high standard. On the disk 
three main pans of Ihe sonwaic, 
namely, Geoassembler. Geolinker and 
Geodebugger. Il contains tiles 
with the complete Geos operating 
system equates and macros and three 
sample Geos applications to show 
you just how simple it all is. Before 
we bo any deeper, an equate is a 



constant or absolute memory address 
A macro is a machine code roulini 
that is given a name and can h. 
inserted in any other machine code 
and can be called by simply inserting 
it's name. Macros can also be a set of 
keystorokes or commands called by a 
single name in Geodebugger. 

Berkeley say that Geoprogrammer 

UNIX based development system, 
used to produce the Geos operating 
system and it's applications. Perhaps a 
slight exaggeration, but it is a superbly 
designed development system and 
when used in conjunction with the 
Commodore RAM expansion units it 
provides one of the best debuggers I 
have seen on the Commodore 64. 
Introductions over, slight pause for 
sunlight, refreshments and fresh air, 
and we will take a look at a standard 
development session. 

convert 6502 assembly language 
source code and produce a linkable 
object file. Simple enough but 
Geoassembler takes it's source text 
from Geowrite, which may seem a bit 
strange but does have it's advantages 



binary data by Geoassembler. Also, 
thanks to the Geowrite environment. 
Italic or Bold type styles and different 
luded to highlight 



i!Ti|.K.iruii si 
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Anything normally done in writing a 
document can he done in the source 
listing without any effects on the 
assembly process. 

Because Geoassemhler recognises 
and uses labels, the source code can 
have symbolic names making it much 
easier to understand at a later date. 
How many times have you written a 
piece of code only to come back to it 
a few months later and not have a 
clue what it was supposed to do? 
Also, it removes the necessity to 
remember important addresses and 
routines. Geoassemhler even accepts 
and distinguishes between local and 
"lnb.il equates as shown in fig 1 - 

It supports all official MOS 
technology mnemonic instructions, 
also, support is given to macros which 
can reduce the length of the source 
code and make il much simpler 10 
understand by allowing a simple pre- 
defined command to replac 



standard 11 



ivlth 



__.!», a complete library of 
if code can be constructed in 
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FEATURE 



You might use j maim lite this in 
your code. 

SuBW subtrahend, minuend 

;subtract wofd 

Geoassembler could expand this 
into the following at the desired 
location automatically. 

SuBW: 

Ida minuend .gel byte value 

■-iit subtrahend isubract low byte 
sta minuend ,'overwrile minuend 

with result 
Ida minuend+1 ;high-byte with 

sbc subtrahend+l 
sta minuend+1 

In this case, SuBW is [he label for 
the macro. 



Figure 1 



developers use standard blocks ol 
code lilted together to produce a 
program. Fig I shows an example of 
this at work. 

complete mathematical evaluatorand 
standard mathemaliial symbols can 
be used in the source code. These are 
handled at assembly time and also 
increases code readability. 

Once the source code is written it 

Geowrile document. I he ne»t stage is 
to load Geoassembler .intl assemble 
(he source code into a relocatable 
object code file. This is not the final 
form as it has no specific address and 
true machine code. In this form, it 
could be located anywhere in the 
computers memory Hid slill operate 
correctly once linked to thai address. 
It is good practice to keep a copy of 

the entire program is complete, you 
need to relocate the routine. 

The nest stage is to use Geolinker 
to anchor the relocatable objed code 
to an absolute address Geolinker is 

relocatable object code liles together 
to form a complete application that 



can occupy the complete computer 
memory. Geolinker is capable of 
producing Geos VLIK anil S('(|uenlial 
files and also standard Commodore 
application files for running outside 
Geos, Geolinker uses a seperale file 
formed in a similar way to our original 

control the linking process and give 
directives, a file name and expression 
that affect the linking process. 
Geolinker is able to resolve cross- 
references involving different 
relocatable nbjeil Code files, wow!. 
Sounds complicated but what this 
means is, if you have a label which is 
used throughout different parts of your 
final application and maybe different 
files, it need only be defined in one of 
the object code tiles and Geolinker 
will carry it across to the other 
sei lions. Perhaps Ihe mosl impressive 
failure of (.".ei.is style programming i- 
the VLIR file, which, typically has one 

overlay modules which are loaded in 
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This is where th 




Geoprogrammer co 





( a-odel nigger. At first, I was surprised 
to see that using Geodebugger, you 

return to a dull plain text display, but 
Ihe reason for this is to pack as many 
lealures into memory as possible. 

At this poinl I found it vital to have 
a Commodore Ram Expansion unit 
(REU! in place, as the mini debugger 
which Geodebugger is supposed to 
defaull to (but I discovered that it 
stubbornly refused to do, unless I 
manually force it) is very restrictive. 
Not surprising when you consider the 
memory restrictions imposed when 



Geodebugger and slill leaving enough 
room for an application. With an 
REU, Geodebugger loads the super- 
debugger into the expansion Ram 
leaving the standard computer 
memory almosl untouched, providing 
a heck of a lot more features, 

Differences aside, you can run 
your application along side 
Geodebugger and inlerupi it al any 

breakpoints, check registers and 
disassemble any code. It includes a 
complete expression evaluator and is 
therefore capable ol disassembling 
and labelling the machine code with 
your own original labels, It even has a 

disappointed to lind that there is no 
printer support in Geodebugger, 
therefore you cannot make a hard 
copy of a section of code to take 
away and study out in the sun when 
[lug hunting. I believe this is a bad 

not provided, expecially when all 
other Geos applications have such 
good printer support. 

All in all, a very desireable 
purchase for any aspiring Geos 
progiamnier in LbA programmer lot 
that matter, also a very useful utility if 

you are learning lo program in 
assembly language. I would like lo 
see any future versions include belter 
printer support, and would advise any 

Com mod ore memory expansion unit 
to make lull benefit of Ihe software. 

It would be nice lo see dislribulnrs 
supplying Geoprogrammer packaged 
with Ihe REU. or Geos packager! wilh 
the REU with a reduction in price as 
we have seen w ilh disk drives. 

I hope that I did not get too 
involved, although I could have 
mentioned many other lealures, bul I 
hope that I have provided useful 
reading for Geos users. If I had jusl 
struggled writing a game using a small 
memory monitor I would be feeling 

Suppliers: Financ ial Systems Software 
Ltd, Masons Rhyde, Defford Road, 
Pershore, Wo res 
Price: £39.95 
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- Planet Dillon 



computer games have sequels to the original story. CDU presents for 
your pleasure LIMBO II - Planet Dillon 



Many of you will recall LIMBO that 
was on the DECEMBER 1989 disk of 
CDU. Unfortunately, as you may now 
realise, our intrepid Editor made one 
very tiny error at the time. He pul the 
wrong version of the game on the 
disk, consequently the one published 
had a few problems built in. 
(Otherwise known as bugs.. 



ptese 



for 



it the 



updated version of the original, aptly 
titled LIMBO II - Planet Dillon. As 
before, plug your joystick into port 2 
to move Wolthamstow around each 
zone. The idea of the game is to clear 
all of the blobs off (he squares whilst 
avoiding the Dillonite guards. Contact 
with these or the scrolling background 
results in energy loss. Flashing squares 

moving squares on them are random 
squares. If you move onto one of 
these and press the fire button, 
something at random will happen, fit 
could be good, bad or extremely 
bad). Squares with moving arrows on 
ihem hurl you off in that direclion. 
That's all there is to it!! 

The Editor in one of his more laid 
back moments decided that it would 
be a good idea, if every now and then 
the readers got to know a little about 
the programmers that provide us with 
our entertainment. So here, for your 
inquisitive minds, is a profile on the 
author of LIMBO, Steven Pattullo. 
Take it away Sieve. 



STEVEN PATTULLO 



FULL NAME: He Pattullo 
AGE: 20 
HEIGHT: 6 T 

PREVIOUS GAMES: Albert saves the 
world again, Albert saves the world 
again It Hyperactive. UFO. UFO II. 
UFO III. Sphere. Sphere II. Trivial 
Challenge. Limbo. Platfomwiia and 
numerous articles on programming. 
FAVOURITE FOOD: Anything that's 
classed as unhealthy. 
WORST FOOD: Vegetables. 
FAVOURITE DRINK: Lager [Holstein 
Pi Is on draught). 

PETS: One eilremely fat Cocker 
Spaniel, 2 fish and a younger brother. 
HOBBIES: Drinking and playing 
snooker. 

FAVOURITE GAMES: This is going 
back a long way to my Spectrum 
days. I would have to go for Manic 
Miner, let Set Willy and a game thai 
was never released called Pud Pud. 
WORST GAMES: A lot of the stuff 
thai is being churned out now. The 
problem is that people are trying to 
make games better and better and 
more often than not, you end up with 
a game thai is only suitable for 
someone with an IQ of 6 million and 
has 2 dozen pair of hands. I think 
people should go back to the formats 
of about 1484-1965. The games that 
were around in this period may not 
have had the besl graphics and sound 



but they were a damn sight more 
playable the a lot of stuff these days. II 
rest my case) |l must admit thai I agree 
with you Ste...Ed!!} 

FAVOURITE SOFTWARE AUTHOR: 

Matthew Smith (when he was 
around). If he wrote a game today I 
would go out and buy a Spectrum. 

Thank you Sieve for imparting such 
wisdom to us. I think as compensation 
for putting the wrong game on the 
disk originally, you ran now give us 
your diary of events leading up to 
LIMBO II being finished. Take it away 
(again) Steve. 

DAY 1 

CDU have asked me to write a diary 
for my new game (fame at last). The 
game is going to be a follow up to 
one of my other games "LIMBO". So 
far I have designed a few graphics but 
nothing to write home about. Spend 
the rest of the day thinking about the 
game plan, various things spring to 
mind such as: 

1 . Is it going to scrollf 

2. What style of graphics should I use? 

3. What type of spriles are going to be 

4. What colour schemes should I use? 
The answer to all these questions 
is....erm...l don't yet know. Tried to 
think of a name for the game, fail, 
some intelligent person in the pub 
suggested LIMBO II, what an 
imagination. 




DAY 2 

Decided that the game will 
screen and the graphic blocks will be 
designed so thai they can be any one 
of 6 colours plus the 2 multicolours. 
Wrote the graphic packer, this packs 
the screen into 60 bytes instead of 
1024, quite a saving me thinks. Fed 
some data into the packer in hope of 
60 blocks gracing the screen, instead 
a mass of junk appeared, (that's a 
good start), had a look through the 
code, fixed a few bugs, ran the 
program again and this time got a 
blank screen. It was at this time that I 
decided that it would work better with 
a character set in memory. Wrote a 
small routine to animate the dots in 
the middle of the blocks, this worked 
first time. Flushed with success I put 
the main sprite on the screen, 
Uurrrghhhh! In my infinite wisdom I 
designed the sprite on a black 
background forgetting that the game is 
played on a light play area. Changed 
the sprite and the colours and tried 
again. Looks much better with a black 



work while the going's Rood. 



DAY 3 

Off to Liverpool to get my Amiga out of 
hospital. At the shop I Was informed that 
il needed a new drive, new nxiuse, and 
several new chips and circuit boards. I 
wonder if you can get Amigas into 
BUPAf Messed around with my 
revamped Amiga for the rest of the day. 

Wrote the joystick routine and put in 
the screen boundaries. You can now 
move the character happily around the 
screen. Decided it was time you could 
eat the dots so in went the routine to 
check what character was under the 
sprite. If the character is part of the dot 
then remove it from the screen, simple. 
This routine will be used to check all of 
the other blocks you can touch. 

DAYS 

Altered the pick up dot routine so that 
when you pick up a dot a hole 



graphic packer was changed slightly 
so a new 4"4 block can be printed to 
the screen, this block is made up of all 
seemed a bit 
of a wasted having sixteen characters 
the same, and anyway this block will 
be rolled around. Wrote the routine to 
roll the characters in this block, the 
block now rolls in the opposite way to 
the way that the joystick is pointing, 
hmmmm looks ok but not loo good. 
I'll keep il there for now anyway. Had 
a good idea on how to move the 
enemy around the levels, I'll try that 



DAY 6 

Hopefully the enemy movement 
routine will be put in today. The way I 
moved the enemy in LIMBO was to 
read in the data for direction, speed 
and how far the sprite should travel 
before switching course. This took up 
too much data for my liking, so in this 
game the enemy will follow arrows 
around each screen. Wrote the 
routine to check this for the first sprite 
and assembled it in great 

confidence well an enemy sprite is 

there hut he only moves jerkily when 
I move the joystick. I have decided 
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THE DISK 



that this is illogical and il cannot 
possibly happen. After a good look 



jugh the code I discovered thi 
bug, the program was jumping past 
my sprite move routine u 
moved the joystick (surpris 
Altered the code so it does 
sprite routine and low and behold 
Nasty sprite starts to zoom around the CRASH 
screen, he comes into contact with 
one of my down arrows and goes up. 



animated il. Looked quite gooc 
10 efforts on ihe character ed 
have decided that the enemy » 
allowed to teleporl as well as you. I 
just because they're enemy they 



This is IK 



ter DAY 13 

: I Oh happy day, my younger brother 

be has gone to Austria for 10 days (peace 

r, I at last]. In went in the routine to 
;he blocks. This proved 

.rprise) don't have to have all their privelages rather easy as it was pretty much the 

ess my taken away. Wrote the code to same as the graphic packer. Typed in 

■ leport you assembled it... .and all the colour data tor level one and 

ggghhhhhhh!!! Even everything looks nice. Each level will 

ave me this time. This take 171 bytes for everything. This 

w it should give you a means I can fit 5 levels into 1 K which 



illy annoys 

. h*ea this small bug 5 second warning or print up a little ..... 

ndles off in the righl message informing you that it's about check if you have completed the level 

..? . ■ ... .-i - ... , tnA i or. i j ilpmn nif ii. P.iij Eves. 



direction which is jolly decent of 
Had a look at how much raster lime I 
was using, wish I hadn't bothered, my 
latest ultra compact sprite mover 
routine lakes about half a screen full. 
After a long think I decide there's only Fixed a bug 
one thing left lo do PANIC!!!! 

After a quick pint in the Bradley, 
decided to tackle the 



a k-le|)i .rl t< 



■ the rouline. 



loaded up the program and as if by the 



lock up. You c 
■ompletely K 



DAY 9 

n the teleport routine 
teleported you off tht 

anybody. Wrote the rouline to movt 



v blocks that a 



magic it had fixed itself! Suits 
who am I to arguei 
down, this is the first 
from the outside world has seen I 
game, overall views.. .Not bad foi 
weeks work. Not bad! I mean wr 
does he want after a weeks work? 4 were irone. 
thousand non flickering multiplexed stamp aroui 
sprites running at the same time as a quid on the I 
72 piece digitised orchestra and a the day off. 
sampled after dinner speech by the 



hurtle you off in 
me Also checked for you hitting these 
.rial blocks, all this works fine for a 
the change. In went the sprite animator 
today, needless to say this did nol 
■k first time. After a couple of bugs 



I the 



and sent a demo off to Paul Eves. 
DAY 14 

Wrote the level complete routine, it 
looks quite good with a few coloor 
cycles, then disaster. The computer 
locks up courtesy of the CECB. Even 
hurling abuse at il does not work. I 
am nol impressed. 

DAY 15 

After yesterdays little disaster I decided 
to change the end of level idea, I want 
it to be like LIMBO with lots of raster 
bars bouncing around the screen. 

display 50 



pne in today and worked 
tany bytes I 
t up c 



my -pulci " 



imation etc. Decided to put in 

.... _ach other exploding block if you touch if 

happily around, they even obey my explodes underneath you 

direction arrows. Oozing with have to use a sprite lor this 

confidence a couple more direction take up too many ch 

arrows are thrown onto the zone and otherwise, 
they totally ignore these. Hacked 

around with the character detection DAY 11 

routine for a bit and everything now Today saw the InttodttCt! 



DAY 16 

Started to put some different colour bars 
into Ihe table and arghhh glitch, glitch, 
Id need flicker, flicker. Disaster, all the bars havi? 
jrs and distorted. Fixed the glilching bul it still 
looks terrible so out il wenl. I'll have lo 

think of something else now. thought 

I will of something else and done it. Much 
would better, it looks a bit like the one from 
acters LIMBO, well it looks extremely similar 
to the one from LIMBO. Ok, I admit il, it 
IS the one from LIMBO, IxjI who cares, I 



blocks were designed for nasty things, 
such as arrows which push you along 
in one direction. The game now has a 
name courtesy of Julian Dolan, he 
came up with The Planet Dillon' 
which is really stupid but who cares! 
That should do it for today. 

DAYS 



I you a 



DAY 17 

Put most of level 2 in today, it's really 
boring typing in loads of numbers but 
Level one is now playable I am it's got to be done, finished this off 
pleased to say. and went to the pub. 

DAY 12 OAY 18 

No work done today but Desmond Started off the day by sorting out my 



leporl block and Dez... . Happy m 
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The rolling characters now look a lot 
better. Pul in ihe rest of level 2 and 
everything is looking preily good. 
Decided to have a go on the sprite 
editor. Aftef an hours worth of effort 
all hope is ahanrioned of churning out 
something half decent. Darren 
pirasso' Russell came to see level 2 
and he had a major moan and a nag 
about the colours. He forced me to 
change some of the blocks colours to 
blue, I must admit it does look better. 

Darren looks smug consider 

punching him in the nose. 

DAY 19 

In went the third level today, I'm 
gemot; really led up of typing in all this 
data and I've only done 3 levels. Wrote 
the score routine, it doesn't just add the 
score on, it counts it on Ooohhh, 

DAY 20 

Started off the day by backing up 
everything in sight onto a new disk 
and drew some new graphics which 
took me hours. 

DAY 21 

lype.d in level 4 and had the rest of 
the day off. 

DAY 22 

Oh disaster, the level I saved out 
yesterday has turned into a sequencial 
mi I i - ir ■ "i i>, id I hv ■■ into rrii-:ivii\. 
Tried to rescue the file but no luck, I'll 
just have to type it all in again. This is a 
bad day, I've just received a letter 
(death threat! from the inland revenue 
and I can't find my accounts book 
anywhere. Re-typed in level 4 which 
was extremely exciting, I then managed 
to send a command down my serial 
port which makes the disk think that it 
is write protected (not good). 

DAY 23 

Designed levels 6, 7 and 8. I then 
found out that my enterprise 
allowance scheme has expired so I 

DAY 24 

|ob hunting!! 

DAY 25 

Typed in all the data for the latest 



three levels which was immense fun, I 
decided it was about lime the 
exploding bloc k rouline went in, so in 
it went. All that needs doing to it is 
the sprites designed lor the explosion. 
I have decided that the teleporter will 
no longer be a teleporter but a 
random block that does different 
things when you touch it. 

DAY 26 

Designed some other levels because 
that's all I had time to do, 

DAY 27 

Started off the day by drawing the 

Loaded up the game and put in the 
new sprites, not bad I suppose. Started 
some of the routines for the random 
block and some of them are really 
nasty, (ha ha, I think the strobe routine 
is really good). First bug of the day, lots 
hi little blocks pop up here and there, 
very pretty but totally useless. I'm in a 
no win situation, I fixed the bug that 
kindly distributes blocks all over the 
screen and now you cannot eat the 
dots HELP!!! I had a look through the 
code and found out that one little line 
had been put in the wrong place. 
Everything is now going ok, so I wrote a 
-null program in blank out the random 
block when you use it. 

DAY 28 

Had to re-write a small-part of the 
random block routine because one of 
the files on the disk was adamant that it 
wasn't going to load. More work or the 
random block, it now has a lot more 
features on it. Designed and keyed in all 
of the data for level H. put in the routine 
that counts down your energy and 
CRAAASSSHHH! Good job I saved out 
the level data before. I haven't lost 
much work really. Re-wrote the routines 
and saved out before running them, the 
same thing happens again even though 
it can't possibly. Ha! found it at last. I 
was thinking there was 4 bytes in the 
eneti;\ in tad there are only 3. 

DAY 29 

Had a discussion with Darren last night 
ahout the game and he decided he 
didn't like the exploding block. He 
insists that is should electrocute you 



instead of blowing you up. This is 
equally violent but it saves me a sprite 
(ponder, what can I do with another 
spritei!. So in went the elei triry inline 
it's ok I suppose. Found yet another 
thing that needed altering, when you 
activate a random Mock it is replaced 
with bac kground characters that take 
energy off you, so me being the 
generous type I replaced it with the 
dead dot graphics. I have decided thai 
when getting electrocuted, the sprite 
will change so that he/she? looks 
unh.ippv. Well would vou look pleased 
with aUXK) volts going through you? I 
think not. Designed the unhappy 
character and in he went. Made the 
random block more rain loin and added 
a new feature. You can now die when 
you run out of energy. 

DAY 30 

Coded the title screen today, pretty 
simple stuff. Colours cycling and 
glowing. Has anybody got a dancing 
flower yet? (no I'm not cracking upl 
when they hear music they dance. I 
have decided that my game has to 
have dancing sunflowers in it. 

DAY 31 

Designed some graphic s for a danc ing 
sunflower and put it in Ihe bottom 
border of the game. De-ignerl another 
couple of levels and put them in. The 
game is now finished I just need some 
other things like game over. 

DAY 32 

Wrote the game over routine today, it 
looks quite effective with characters 
rolling around at different speeds, also 
put another thing in lor those of you 
that dare press the RESTORE key??? 

DAY 33 (The final day) 

Linked all of the routines up today 
and everything is working just fine. 
Put the game on a disk and off it went 
to Paul Eves. Well all you people in 
reader land, that's it, finito end of 
game. Hope you like it anyway. 

Thank you Ste for a most informative 
and interesting diary of events. I 
certainly enjoyed playing your latest 
offering. I hope everyone else does 
also. Ed! 
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SCREEN DESIGNER 
128 

A handy utility to help in designing text screens in both 40 and 80 column mode 



5 the C64 



I'm sure you agree thai a nice layout 
oi menu and help screens makes any 
program more user-friendly. '" 
designing the 
programmer can cnoose rrom a 
plethora of available programming 
aids, the l 28 user however has very 
little software available to them. The 
utilities described here offer C128 
programmer; an easy and familiar 
editor to design text screens 140/80 



F2 TO PUT A NEW GRID ON THE 
WORK PAGE. 

This option returns the workpage to 
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I in packed form, optionally 
with a loader which enables you lo 
recall them with lightning speed in 
your own programs. Plus a software 
switch to turn the HO column screen 

You will need the programs 
SCREEN DESIGNER. SCREENED 
CREATOR and V-SWITCH CREATOR 
on disk or tape. (All these programs 
are provided on the CDU disk). 

USING THE DESIGNER 

Assuming your C12B is in power-up 
state. Start the program by the 
command:- RUN"SCREEN 
DESIGNER". Three remarks are in 

The screen type, 40 or 80 column, 
on which you execute the RUN 
instruction will also be the one you'll 
be working on. If you want to load or 
save a screen, the program uses the 
device which was used most recently 
before the program was started. Any 
option which would destroy the 
contents of the screen you have been 
working on is executed only after you 
have acknowledged an "are you 
sure?" question. The options available 
lo you on the menu screen are; 



F1 TO ENTER THE WORK PAGE. 

If you start from scratch you will see a 
grid, which should help you to place 
the characters on the desired position, 
with the cursor flashing in the too left 
corner. The editor used should be 
familiar as it is the same one as used 
by Basic. In other wotds, you have the 
same facilities as in direct mode with 
all CTRL and ESC codes available. By 
pressing RETURN you leave the 
workpage and return to the menu. To 
avoid lines scrolling off the screen, 
scrolling is disahled when you enter 
the work page IESC L enables it 
againl. A few remarks and warnings; 

Be carefo.ll with deleting and 
inserting lines using ESC D and ESC L 
For example, if you insert one blank 
line then try to delete it again you will 
probably discover you have deleted 
the next line as well. This happens 
since the editor was originally written 



F3 TO LOAD A SCREEN. 

A file is loaded from the same device 
as the screen designer was loaded 
from. It is irrelevant if the file starts 
with a loader or not (see below) but it 
should be of the correct type. (40 or 
BO column). Following a succesfull 
load you will find yourself on the 
workpage. 

F4 TO SAVE A SCREEN, 

First you are prompted with the 
question whether or not you want to 
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input 



Do not accidentally press 
CLR, it immediately destroys your 
work, no questions asked. You may 
not switch to the other screen (ESC X) 
and if you do hy accident, switch 
back immediately. Except for this 
ommission the program is, to my 
knowledge, reasonably idiot proof. 
Once on the workpage, you have one 
or more additional options available. 
Fu changes the background colour of 
the screen. In 80 column only, f7 
and F8 Higgle the flash and underline 
bit of the current attribute respectively. 
(And move the cursor by one position 
afterwards). 



... „ the background colour and, 
for the 40 column screen, the chosen 
character set) are stored, a judicious 
choice here allows the pack routine to 
produce more compact files. This 
option, however, also serves a 
purpose ot my own. If you are familiar 
with my MouseSO utility (YC 
luly/August 1989) you may recall that 
the mouses' arrow assumes the colour 
of the characters it is moving over, 
instead of imposing its colour as the 
normal cursor does. By carefully using 
shifted spaces and normal spaces and 
defining different colours for each, 
you can have different colours tor the 
arrow in different sections oi a menu 
screen. The next question you have to 
answer is whether you wish to save 
the screen with or without a loader. 
The ins and outs of this matter will be 
treated in the next section. For the 
time being save an as yet incomplete 
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have 10 deiine a file name anVlhe 
program saves I he screen on Ihe same 
device as the screen designer itself 
v, J* li),ult-il from. 

F5 QUIT PROGRAM. 

When fhis option is selected a system 
reset is performed. 

IN YOUR OWN PROGRAMS 

Let us assume you have saved a 
screen with loader. The loader is a 
piece of code written in such a way 
that it is relocatable. To you this 
means fhat you can load the tile to 
almost any address in RAMO and 
execute it from there {of course you 
may also make it a part of your own 
programs). The only forbidden 
locations are the I/O area (SDOOO- 
SEOOO); no part of the tile may be in 
the ROM underneath it; also you 
should be caretull when using low 
addresses which might be used by the 
operating system or by the Basic 
interpreter. In order lor the loader to 
do its job there is a certain protocol to 
be followed. (Described here for Basic 
programmers, assembler fans will find 

requirements). 

Three pairs of zero page locations . 
should be poked with addresses 



(low/hii;h: as follows: 

$FA/$FB 1250/251) where to put the 
characters 

SFC/IFD (252/253) where to put 
colour/attributes 

IFE/SFF (254/2551 start address of the 

For example, it vou have loaded a 40 
column file to 191 23 137155) and the 
characters should go to the standard 
VICII tent screen ($04001 and the 
colours to the colour ram (SO800), 
you should use: 

POKE25D,0:POKE251.4:POKE252,,0: 
POKE253,216:POKE254,35:POKE255 

Next, you can have Ihe screen shown 
by BANKO:SYS3715S 

For B0 column files the addresses 
specified in SFA/SFB 1250/251) and 
JFC/SFD (252/253) pertain to the 
VDCs video ram, normally $0000 for 
the characters and $0800 for ihe 
attributes. This procedure works in 
direct mode as well, uselull lor It-sting 

The proper idea is not to unpack 
the file to the current screen, but 
rather to another location in memory 
and set the screen pointer* to ihese 



responsibility In ensure thai you do 
not try to 'unpack' and 80 column 
tiles to the 40 column screen and vice 
versa. Also, in 40 column mode you 
must take care that the packed file 
does not overwrite itself. The method 
rlesailx-d here is fine it you have only 

waste to attach a 388 byte loader to 
each screen. A better alternative is 

AN ALTERNATIVE LOADER 

When you are using any menu or 
help screens it is much more etlic ient 
to use a single loader and have the 

locations in memory. To Ihis end Ihe 

loader lit you should have forgotten if 
a cenain file included a loader ot not, 
or lor which screen type it was meant, 
read the next section). This section 
describes such a loader for Ihe B0 
column screen, if you want to write 

screen, I again refer you to the next 
section. First let me enlarge upon the 

utilities and programming aids are 
written in such a way that they should 
be loaded to a specific memory 
localion. To the user this means a loss 
of flexibility. He/She cannot use this 
area lor their own purposes or use 
other utilities that require the same 
memory locations. When dealing with 
machine code programs one might be 



try and write completely relocatable 

references lo memory locations within 
the program. If at all possible, this 
lends lo make the programs longer 
than necessary and is feasible only for 
relatively -mall pu-t es of code. 

For the alternative screen loader to 
be described in Ihis section I opted lor 
a different approach. The program 
SCREENLD CREATOR, which can be 
started by RUN<name> ION Ux] in 
128 mode, contains aparl from the 

machine code, a table with addresses 
to be relocated. (Much as a linkage- 
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editor does in larger computer 
systems). After you have defined the 
base address the program saves the 
correct code to the same device as il 
itself was loaded from. In this way 
you can produce code for the 
location that is most convenient to 
you. The previous screen loader 
required you to define the target 
addresses for characters and 
attributes. This on retrieves these from 
the VDC registers and blanks the 
screen untill the new screen is 
complete. Also, although the loader 
itself must be in RAMO the packed 
screen files may be located anywhere. 



i SFE i 
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Poke addi 
1254/255) with the low/high addi 
byles of the screen file, then call the 
loader as 'BANK0:5YSxxxx,B' where 
B is 0 or 1 for a screen file in RAMO 
and RAMI respectively. For example, 
if the loader is at J9123 137155) and 
the screen file at SAOOO (40960) in 
RAMI you would use: 
POKE254,0:POKE2S5,160:BANKO:SY 
S371S5,! 

WRITING YOUR OWN LOADER 



and not for recurring patterns of bytes. 
Here is how to unpack the file. 

First read a count byte, bits 0-fi make 
up 1 number between 0 and 127. If 
bit 7 was zero, the next (0-127) +1 
hytes should be transported to the 
target aridress. If bit 7 was 1 then the 
next byte is io be duplicated 10-127) 
+1 times to Ihe tanjet address. 

VDC SWITCH 

i you experiment with the 2nd loader 
described above you will probahly 
notice it neatly blanks the screen until 
the new screen can be turned on. 
When dealing with the VICIl chip, 
which handles the 40 column screen, 
you have various options to achieve 
this effect. For example, you may use 
a raster interrupt outside the visible 
redefine the screen 



multicolour mode (as used here), in 

foreground colour. Therefore, if the 
two nibbles are made equal then 
switching between multicolour and 
monochrome mode is equivalent to 
switching between screen on and off. 
Remains the problem of waiting for a 
"dark" period. You will know that the 
VDC is addressable only through a 
gateway of 2 bytes in the I/O area, 
JD600/$Df>01 . When reading 
location SD600 bit 3 is 0 if the beam 
is writing part ol the screen and 1 if it 
is in the blanking period. Vou have no 
means however to know how many 
clock periods the beam is away from 
entering the visible area again. 
Therefore the proper procedure is: 

Wait for the beam to he on-screen. 
Wait for the ne*t blanking period. This 
way you have sufficient lime to 
change the contents of the registers. 
This method is used in the alternative 
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how to distinguish between 
with, and a file without a loader: thi 
loader starts with a SOB byte [PHP), . 
file without never does. Not coun 1 
the optional 388 byte loader the 
starts with a code byte with th 
following meaning: 

b»7: 0 or 1 for 40/BO columi 
respectively 

bit6: 0 or 1 chooses betweei 
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bit5: Irrelevant 
bil4: 1 (Thus this byte is never SOB), 
bits0-3 Define the background colour 
to be poked to SD020 and SD021 for 
the 40 column screen, and to the right 
nibble of VDC 's register 26 for the B0 
column screen. 

Next follows two times 1000 (40 
column) or two times 2000 (80 
column) bytes, the characters and 
colour or attributes respectively. The 



pointers or to turn the screen on or 
off; or you could read the value of the 
current screen line until it reaches the 
desired value and then do whatever il 
is vou wanted to do. 

The VDC chip, responsible for the 
80 column sc reen,- does not support 
raster interrupts nor can it be switched 
off (that is, by software). Nevertheless, 
with a little trick the same effecgt can 
be achieved. The right nibble of 
register 26 defines the background 
colour, the left nibble is irrelevant in 



loader described above, hut it could 
also be of use for other purposes in 
your own programs. To this end you 
should RUN-V-SWITCH CREATOR" 
in 128 mode. This program allows 
you to create a machine code file for 
the base address you select. Since the 
piece of code is very small, 86 bytes, 
this repeatability is of spec 
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from Basic as BANKt):SYS<address> 
where each call toggles the VDC 
screen between on and off. 
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DATABASE 78 

A RAM based disk filing system which is simple to use and understand for all ages 



M.niy |*'iiple that use r.ompuleis do so 
not simply as a leisure activity, but 
also lor wimp serious work. The most 
widespread use at any computer is as 
a filing system, either for large 
multinationals, small businesses or 
simply for the man in the streel to 
keep trac k oi his records, DATABASE 
7H ji, a program thai will enable you to 
do just that. It is a simple program that 
is user friendly and easy for people of 
all ages lo understand. 

One of the first things you will 
prompted lor on running the program, 
is to state what type of printer you will 
be using, either COM or STAR LCI 0-C. 
The name of the file that is present, if 
there is one, is displayed at the top of 
the main menu. From the main menu 
the following options are available. 

A - START A NEW FILE 

This option is self explanatory. It is 
used to create a completely new file 
from the begining. The maximum 
number of records is fixed at 300 and, 
ihe rijrnlie' or i'ie il- s ii\«i .it -I. Iln- 
top of the screen states that you can 
enter a maximum of 78 characters in 
each field. The display as you type it 
in is how it will appear in the other 
options arid on the printer. The file will 
not accept a nil entry in a field, so you 
will have to put something and I 
suggest you use a 0. Do not use 
commas or colons as any text entered 
after these will be lost. Typing EXIT to 
start a new field and then RETURN 
will delete that record and return you 
to the main menu. 

B - LOAD or UNLOAD FILE 

Follow the prompts and use this 
option to LOAD an existing file from 
your disk. If a file is already loaded 
then use it to clear the file before you 
load a nol her. 

C - SAVE THE FILE 

Use this facility to save a new file that 
has nol been SAVEd before. II can also 
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be used to provide a safety or bark-up 
copy on a seperalion disk from your 
working di-k In tin- l.ittei < ase use this 
last before switching off. 

D - DISPLAY FILE (scroll) 
This displays the file one record at a 
time. You can use the U and D keys to 
move UP and DOWN through the file. 

displayed at the top to provide an 
indication ol your position in the file. 
The space bar takes you back to the 



E - ADD RECORDS 

This returns you to the point at which 
you left off when making your file 
originally. You are also told the record 
number you are working on. Don'1 use 
commas or colons as all text entered 
alter these will lie lost. Typing "EXIT" 
will return you to the main menu. 

F - ALTER RECORD 

You are firsl of all asked to name the 
record by its firsl (main) field. The 
display shows you the record as it 
exists and askes you which field you 
wish to operate on. This question is 
then replaced by the field that you 
stale. After the field has ln-en altered, 
keying RETURN will enter the change 
and ask you if you want lo alter 
another. Keying "Y" will repeat the 
process and keying "N" will return 
you to Ihe main menu. 

C - SORT BY ANY HELD 

You are firsl asked for the field to work 
on. For example, ii you enter DATF OK 
BIRTH as the name of one of the fields, 
it will arrange all Ihe records in numeric 
order. If you type OCCUPATION, it will 
sort all the records of that field into 
alphabetical order. This is best 
appreciated by experimenting and then 
choosing option "D". Ii you have asked 
it lo sort by the main field you can use 



option "V" in the SUB MENU to get a 
good idea of Ihe result. 

H - SUB MENU (sort and search fields) 
This option takes you to j whole range 
of further options, including the 
PRINTER option. However, you can 
only gel lo ihe sub-menu if you have a 
file already present in memory. 

/ - DISPLAY RECORD {delete option! 
You are first asked lo name the record 
by its main field. The display ,]llow^ 
you to view the record as a seperale 
entity but gives you only two choices, 

10 delete or keep the record in 
memory. If you accidenlly delele a 
record from memory, all is not lost as 
you should still have it on disk, so long 
as you have not used option f. 

J - UPDATE DISK FILE 

running, or working, records up to 
date. It automatically deletes your old 
file of the same name from the disk 
and replaces it with your updaled 

name. Anything you have deleted 
from thai file has now gone, and 
anything you have added, deleted or 
changed will now appear or not at a 
later re-load. This option only works of 
course when you have LOADed an 
existing file from your disk. It should 
be the last oplion you choose if you 
have made any changes to your 
records, except for oplion "C", when 
you may want to make a back-up 
copy on a seperate disk. 

K - DELETE FILE FROM DISK 

This option will delele or scratch any 
file that you name from your disk. Be 
careful how you use this oplion. An 
escape facility is provider! should you 
make an error. 

L - EXIT PROGRAM 

11 you choose this option, you are 
reminded to update your disk file and 



15 



ON THE DISK 



menu is provided. If you continue the 
screen clears and the READY prompt 

Z - DIRECTORY OISPLAY 

This option will display the contents of 
the directory of any disk without losing 
your loaded file, ft will also indicate 
any protected files, which you can 
alter to suit your needs. 

Database 78 keeps track of how many 
records there are present in the loaded 
file. At the bottom of the main menu 
this number is displayed for your 
information. 

SUB MENU OPTIONS 

MoS 

This is the first of a choice of five 
SEARCH and SHRINK routines that are 
available. By following the prompts 
and entering the data that you want 
omitted, a sub file will be produced 
made up of records that excludes that 
data in the field that you specified. This 
is displayed by choosing option "G". 

N = S 

This option will select all those records 
with, for example, all those individuals 
born in the same year, or all those 
vehicles described as red. You must 
however state exactly and precisely 
what is in the field, 

O >= S 

In a numeric sort this option will select 
for example all those countries with a 
population greater than or equal to 
that which you specified. 

P<S 

If this option is used on an alphabetic 
field then it could for example make a 
sub file in which the names of people 
are lower in the alphabet than the 
particular letter you specified. 

O CHARACTER GROUP 

This is perhaps the most useful of the 
first five options. Unlike the other four, 
the field contents to be searched do 
not have to be precisely stated. For 
example, it will search all the fields 
under NAME for "log" and come up 
with IOE BLOGGS and any other 



names that contain that combination 
of letters. 

GENERAL NOTES 

In any of the options above, you are 
informed if the result is POSITIVE or 
NEGATIVE before being relumed to 
the SUB MENU. Once a sun file has 
been created, all the options in the sub 
menu operate on THAT sub file, not 
on the main file. This includes the 
printer option. Once option "W" is 
selected and you return to the main 
menu, you lose your sub file, unless 
you SAVEd it under option "R". 

R - SAVE SUB FILE 

After using the SEARCH, SHRINK and 
SORT options, operating on and 
reducing the main file and subsequent 
sub files to a final acceptable result, 
you can save if to disk. What you 
create in effect is another new main 
file in its own right. This should of 
cource be saved under a new name. 

S - OISPLAY SUB FILE 

If you enter this option before you use 
any of the SEARCH, SHRINK and 
SORT options, then what will be 
displayed is the main file. Obviously 
you cannot display a sub file if you 
have not created one. The format is the 
same as option "D" in the main menu. 

T - SORT SUB RLE BY ANY FIELD 

This operates on the sub file in the 
same way as option "G" in the main 
menu does on the main file. 

U - DELETE SUB FILE FROM 
MAIN FILE 

After using option "Q" in the sub menu, 
this option will leave you with a reduced 
main file. In effect you will have split 
your original main file into two main 
files. Selecting this option automatically 

V - LIST FIRST FIELDS 

This provides a list of eight of the first 
[mainl fields in alphabetic or numeric 
order is used after option *T". The U 
and D keys operate in the same way 
as option "D" in the main menu. Only 
eight fields are listed at once in case 
all the fields have used two line 



W - MAIN MENU " DESTROYS 
SUBFILE 

Once you have left the sub menu you 
cannot return to it to view your sub 
file. The only way you can see your 
sub file again is if you SAVEd it and 
then re-loaded it, or go through the 
whole SEARCH process again from 
the original main file. 

X - CHECK FREE SPACE IN FILE 

This may lake a few moments, bul it 
will tell you how much room you 
have left for more records. Assuming 
that all four fields in every record use 
up 78 characters. 

Y - SEND TO PRINTER 

This option first gives you a choice of 
two routes. You can either print out 
the whole file or sub file as the case 
may be. This may take some lime and 
a lot of paper if you have a large file. 
Or you can choose to print a specified 
single record. If you choose the FILE 
option it can only of course print out 
that file that is present. If you are 
using a CBM printer you are then 
presented with a choice of upright 
expanded printing in one of six 
colours or one draft style in black. If 
you are using a STAR printer you are 
offered a choice of upright expanded 
or italic expanded printing in one of 
seven colours, plus one draft style in 
black italic. 

An escape back to the sub menu is 
provided. If you are printing a file you 
are now asked to check that your 
printer is switched on or you can 
escape again if you wish. If you are 
printing a recofd you are asked which 
one by the first field. If you cannot 
remember it all, enter the first few 
letters or numbers. The computer will 
make an effor to offer you a record to 
try. Again the chance to escape is 
offered. An additional feature when 
printing a file using either printer is a 
choice of fields in addition to the 
main field. You can print all four fields 
or a choice of the second, third or 
fourth. This is useful if only a limited 
amount of information is needed. 

Z ■ DIRECTORY DISPLAY 

This is exactly the same as option Z in 
the main menu. 
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FURTHER ADVENTURES IN <C 



programmer should be lo produce 
sequentially flowing program code, 
with no unconditional jumps 
backwards or forwards from section 
in scciion of code". 

STRUCTURE 

Any code which is executed 
repeatedly should be so constructed 



IF... ELSE 

Probably one of the most regularly 
used control statements of C, and, as 
it happens, also one of the simplest. 
First we shall look at a couple of 
formal examples demonstrating the 
logic of the statements. 

Formal example I; IF (expression) 



In this case, if the result of th( 
KI'KtSSION is found to be true ther 
STATEMENT A will be carried out 
otherwise the next statement o 
pi 09*11 Code would be executed. 
Formal example 2; IF (expression) 
STATEMENT A:ELSE STATEMENT B 

Here, we can see that if tht 
EXPRESSION is true then commanr 



JOHN SIMPSON 

will execute STATEMENT A after 
which it will skip the ELSE 
STATEMENT B. But on the other hand, 
if EXPRESSION is found to be false 
then command will be passed, via the 
ELSE control statement, to 
STATEMENT B. 



• the 



program CWXrol should always he 
timed out by using the 
.f Htr .do . whilr command 
statements, or the logic equivalents of 
rhi'sr und, ot, nut). 

fheri' are Mime pnigrammi'rs who 

expressions into just one large 
expression which is then sometimes 
used as an impressive example of 
'logicus complexicus', but really the 
only function it will serve is 10 make 
the program virtually unreadable. 
Personally I would much rather write 
them out as a number of single lines ■ 
of code. This makes things so much 
easier to read and understand, 
especially when returning to a piece 
of code which I may have been 
working on several weeks, or months. 



formal examples 
program examples 

/•...lesson 5...5..J 

mainO 



rith a 



luple of 



printfC'Do you enjoy reading the 
CDU magazine? 
nV line 1 '/ 

printiCslrike key <V> for yes, or key 

<N> for no. 
H-V line 2 •/ 
inpul=getchar();/* line 3 "/ 
iflinput == 'Y'l/-line4*/ 
prmti'^Wdl thai is good new for the 



printfCHave you tried reading the 
Chinese abacus monthly, 
instead? 



ft"/ 



n">/* Mi 
I 

The lesson starts off with the usual 
comment line followed by main 0, the 
only function. (Remember, we must 
includa a main 0 function somewhere 
with the programl. Then comes our 
start brace for the statements which 
ill be incorporated with the 



func 



t up a 



integer type nf variable, assigning 
with the name INPUT. Lines 1 and 2 
will simply print out our message, as 
we discovered in lesson 2 of last 
month. Line 3 introduced the C 
command getcharO, (more about 
these, (J, brackets in a later lessonl, 
Cetchar is used to obtain a character 
from the keyboard. Once the response 
is received, the key value is assigned 



to the variable INPUT (note, the 
command getchar alway returns an 
ASCII irileger value). Line 4 is the first 
part of the if.. .else command. What is 
actually occuring here is that variable, 
INPUT, is tested to assess if it is equal 
to the character 'Y'. 

We must enclose the character 
being tested for within single quotes 
because we are comparing the integer 
value of INPUT with a character. The 
quotes simply tell the compiler to 
convert T into it's ASCII form. 

If the value of INPUT is equal to 
'Y' then the result is considered to be 
true and so the statement of line 5 will 
be executed. However, if the variable 
INPUT does not equal the ASCII value 
of 'Y' then the result is false so 
therefore control will drop through to 
line 6, and execute the statemem held 
there. After which we have the 
closing brace of the function, (note 
also the semi-colon, after each 
statement. As I mentioned in previous 
lessons this is very important.). 

Before we continue any further I 
think a quick refresh on the operations 
of "=" and "==" from lesson 4 might 
prove useful. 

(A) TEST=ACTION 

(B) )OHN=PAUL 

(C) SUM==RESULT 

(D) SEA==COODTOSWIMIN 

In the examples (A) and (B) the 
variable on the left is given the value 
of the variable on the right - 'passing 
values'. In (C) and (D) we have 
examples of equality. One would test 
the variable on the left lo discover if it 
was equal to the one on the right. If it 
is. then the result if true if not the 
result is false. 

The next lesson is intended to 
demonstrate just how the IF.. .ELSE 
command can easily produce a range 
of controlled branches. The variable 
names as INPUT will, once again, be 
used to store the users key response. I 
shall also be introducing a new 
command - #INCLUDE <STDIO.H> 
which will force the compiler to 
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include various definitions within the 
main program. Definitions thai are 
covered by this are the EOF (End of 
File) and EOL (End of Line), this 
Command is not strictly necessary 
within this example program but it's 

later. 



/•k 



iches in a functioi 



reply!) ; 

input=getcharl); 
if(input=='t') 

uptt 

else iffinput=='m') 

middle!); 

else if(input=='b') 

bMotntb 



against the three IF.. .ELSE statements 
whic h follow. II one ul the IIH»IWII<I 
is found true then control will pass to 
the appropriate lunclion. For example 
if the user selects key T, then control 
will pass to function TOP!) and the 
appropriate message will be printed to 
the screen after which the program 



n' or 'h' then the program 
without further action. 
Finally, and to end this months 
'ssons. we will now take a look at 
te DO... WHILE command 
alcmenls for passing control from 
ne statement to another. Here then 



I of < 



| pyl) 

printfC Select a position \n\n); 

printfCTOP.. ...strike key <t>\n); 

printfCMJDDLE-.strike key <m>\n); 

printf!" BOTTOM., sir ike key <b>\n); 

|jrintii"\n \n\n"); 

top() 

I 

printfl'VVill sclei ling the lop position 
bring its just rewards?\n); 



I 

printfcDoes sitting upon a fence 
mean you can fall eilher wayfAn"); 
I 

bottom!! 

I 

printfl'ls the weighl oi the whole 
hiiildinj; rt'siin^ upon the bottom 
layer of bricks? \n"l; 
I 

After getting the INPUT variable as 
an integer, the program now calls the 
function. REPLY!), and executes it. In 
essence il prints the first line of text, 
with two carriage returns, which is 
then (allowed by a further three lines 

Once again, as we saw in lesson 
S, the variable INPUT is assigned the 
ASCII value of whatever key is being 
depressed. This value is then tested 



DO.. .WHILE si 



while (Expression) 

Here the statement will be 
executed whilst the expression is not 
true. This is a structure for creating 
control loops, for example, as lesson 7 
will demonstrate. 
/* lesson 7.. .do while or not to do 



printfC'Do while, da dah da do 
while do\n"); 



oul after the increment operation. This 
is line when you know that a certain 
course of action has been carried out 
lor the first lime, or iteration, or when 
you wish the loop to terminate after 
carrying oul a statement. We can also 
write a few lines of code without 
using the DO part of the DO...WHILE 
combination, and that « " 
c before execution of the si 



n 7(a) is 



mote. 



program sted will do the print 
statemenml and then increment the 
varialbe c by one. lln fact, "C 

sophisticated method for handling 
increments and decrements which I 
shall discuss in detail in a future 
lesson). Finally the statement WHILE 
C<=4; means that while the counter c 
is equal to or less than 4 then loop 
back to the DO pari of the lunclion 

c reaches 5 the loop has ended and 
the function will terminate. 

In this example the test was carried 



I 
I 

As I said, the test for C reaching it's 
optimum value has been made before 

allows Ihti loop to be terminated after 
the increment and before the 
statement is executed. (NB: Note the 
way the braces are used to divide the 
different program sections in the 
example programs. This allows one to 
follow the program logii much mure 

which will give much more detailed 
and complicated programs). 

SUMMARY 

1. The introduction ol controlled 
program flow using the IF... 
THEN,., DO. ..WHILE expressions. 

2. The introduction of the *C 
command GETCHAR!); which is 
used to pick up character input 
from the keyboard. 

i. GETCHARO; always returns an 
ASCII integer value. 

4, The introduction of 
#INCLUDE<STDIO.H> 

5. Several functions were included in 
lesson 5. Note that at the 
completion of a lunclion the 



BREAK. ..CONTINUE. ..RETURN. 
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ON THE DISK 



LETTER 
MAKER 

Another novel way of sending information to friends or writing program notes is catered for 



Letter Maker is one of those "■fun- 
utility programs that pops up from 

provide a utility in the true sense of 
the word, but is fun to use and can 
produce some fairly impressive 

The idea behind the utility is 
simple. It allows the user to produ 



s page 
>urful a 



of ti 



t that 



e both 
without the 



normal laborious job of writing long 
lenghty letters, (lets face it, who MAIN EDITOR 
really enjoys writing letters to friends 
and reletives anyway??). 

Using the program is simplicity F3: Centre 



ROBERT TROUGHTON ^ 

CLR: 

itself, lust select the option from the 

main CDU menu, once activated sit INST: 

back and compose your screens. CRSR: 

Below is a quick run down of screen 

available options. There are plenty of HOME: 

on-screen instructions so you should CBM I: 
nol have tin much difficulty in i 
this simple, short but tun utility. 



Clear screen / nor 
Insert character 



Thanks must go I 
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FUNCTIONS 



With this utility you can assign strings 
and character codes to a total of sixteen 
function keys, and save a machine 
code file, maximum 200 characters, 
which can be loaded on lop of a BASIC 
program without destroying it. The 
function keys are defined for use in 
DIRECT MODE only, and their aim is to 
he an aid in the development of BASIC 
programs. The sixteen keys available 
are accessed as follows: 

FKEY NO. ACCESSED VIA 
1-4 F1.F3.F5 and F7 ONLY 
5-8 F1, F3, F5 and F7 PLUS SHIFT 
9-12 Ft, F3, F5 and F7 PLUS 

COMMODORE KEY 

13-16 F1, F3, F5 and F7 PLUS CTRL 

KEY 



available options in turn. 

VARIOUS FUNCTIONS 1,2 and 3 

These are the first 3 options available 
from the main menu, each offering 
eight of the most popular Ifixedl 
definations. Details are given 
cone ■.■mini; the method in which your 
next de tin at ion will be accessed, and 
on selecting a defination you will be 
offered a carriage return. 

STRING FUNCTIONS 

As various functions, except that the 
available definations are all under the 
category of String Functions. 

DIRECT DEFINATION 

Where as the previous options 

consisted of FIXED definations, this 

option gives vuu much mure versatility 

as functions can be defined more 

specifically. Selecting options 1-7 will 

allow you to add to the defination 

chosen, for example; 

LOADT.8 

POKE532BO,x 

SYS64738 

Obviously, to defined every possible 
ind/statement would be 



STUART WESTBROOK 

impractical, so selecting option 6 
allows you to define anything you like, 
simply enter your defination (carefully 
as you cannot use the delete key] and 

EDIT OPTIONS 

After selecting edit options you will be 
presented with the following options; 

1 . INSERT CHARACTER CODE 
(CHRS) 

Select the function number that you 
wish to define as a character code, 
and enter any code between 0-255. 
Refer to any manual for a list of 

2. DELETE OEFINATIONISI 
You are given the opportunity to 
delete ALL definations, replying 'N' 
will give you the option to delete 
any SINGLE defination. 

3. REPLACE DEFINATION 

After selecting the function number 
to be replaced, you are returned to 
the main menu to redefine the 
function chosen. 

4. SWAP POSITIONS 

Enter the first function number you 
wish to swap (press return], and 
then enter the second. If either of 
the function numbers equal 1 7 then 
you will be returned to the main 
menu with no alterations made, 
otherwise the definations are 
swapped and you ate returned to 
the edit options menu. 

PRINT DEFINATIONS 

Remembering how you have defined 
each function can be very difficult, and 
for this reason there is the option to 
print a list containing each function 
method and 



If you have ever wanted to 
make better use of those 
virtually inaccessible function 
keys, then this program is the 
one for you. 

could mean the loss of all data or may 
even crash the program. The printout 
may contain blank lines, this indicates 
that the defination above the blank line 
contains a carriage return. Additional 
details are added to the end of the list. 

SAVE MACHINE CODE PROGRAM 

This is the programs most important 



optio 



allot 



i you t. 



definations in machine code format lo 
either Tape or Disk, meaning that it will 
not only load much faster but it can 
also be loaded over a Basic program 
without destroying it. Again, be sure 
thai the device chosen is ready lor use, 
otherwise it could result in loss of data 
or worse. Please nole that the machine 
code is loaded independently of the 
FUNCTIONS program. 

QUIT PROGRAM 

If you have completed your deli nation 1 , 
and saved your machine code version, 
you may quit the program and execute 
the machine code by SYS491 52. 

THE MACHINE CODE 

Once saved, this is loaded 
independently of the FUNCTIONS 
program and is loaded as follows; 
LOAD'filename'.x.l where x is the 
device number. To execute the 
machine code enter SYS49152. To 
disable the function keys type 
PRINTUSR(I) to reactivate enter 
PR1NTUSRI0). 

ADDITIONAL KEYS 

CTRL and A equals Auto repeat 
CTRL and C equals Remove auto repeat 
CTRL and @ equals Pause system 
CTRL and A equals Remove pause 



concerning whether your pri 

device 4, is ready for use or not. To 
continue when the printer is not ready 



DEMONSTRATIONS 

To demonstrate the use of FUNCTIONS 
there are 2 example files on the disk. To 
given a prompt see them in operation, select either 
DEMO 1 or DEMO 2 from the menu, 
or load direct. Once in memory you 
may activate them by 5YS49152. 
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Adventure Helpline 

Jason Finch provides more help for those that are stuck with CDU's Kron adventure. 



Here we are already with the third 
article in this section ot the Adventure 
Helpline series, covering the epic 
adventure Kron, written by Tony 
Rome. In the two previous articles I 
have explained, through subtle (or 
otherwise!) clues, how you can make 
your way through the first two stages 
of the adventure - the Sea of Storm* 
and the great subterranean system of 
caves. Last month I left you in the 
Valley of the Dead looking at the 
Castle of Spells that is over a deep lake 
to the south. The problem was how to 
get over this lake and into the castle. I 
provided you with two cryptic hints 
and hope that you have successfully 
made it across. But in case you are still 
hurling large objects at your computer, 
the next paragraph explains how it is 
done. 

Firstly, do you remember when 
you released an eagle when it had 
become trapped in a crevice some 
while ago? It left behind a flute and ■ 
you will find that the eagle will return 
to vim in the Valley of the Dead it you 
play this flute. It all goes au ording to 
plan, the eagle will swoop, pick you 
up and carry you over the lake, letting 
you drop safely onto the castle 
battlements. You are now in the third 
and final stage (ti ihe adventure. 

This suction tonlains possililv the 
niosl important and baffling sequence 
of puzzles - how to get passed the 
prison guard and rescue princess Zora 
without being killed by the ogre or 
ullint; ,i-leep! That is not an insult to 
Ihe author - you will find out what I 
really mean a bit later on. Once you 
are on the battlements. Ihe only way 
out thai you can see is by a staircase 
that leads downwards. This would 
seem the most obvious way to enter 
the main castle and so do that - go 
down. You should find yoursell at Ihe 
foot of the stone staircase with a 
passage to the north. You should 
follow this passage until you come to 



the Alchemists Chamber. Take 
whatever is on offer but do not open it 
- the jar contains a sirange potion that 
induces tiredness. Also, make sure that 
you do not stay around too long in the 
laboratory. 

At this stage you should walk 
straight through the large hall lhat is 
found on the other side of the 
staircase. You will then find yourself in 
a magic room with the walls slowly 
dosing in ,] round you. I shall be a little 
cruel here and refuse to tell you what 
to do! - just remember what the gum 
told you was on the st roll because this 
is the time that the walls may move 
your senses! One step in the wrong 
direction and you will be confronted 
by an ogre [hat kills you immediately. 

When you have found your way 
into the castle dungeons you will meet 
the guard who is keeping watch of the 
princess. Here you will need the jar of 
sleeping potion. Open it and the drop 
it on the floor. It takes a little while to 
ad but find somewhere else to wait or 
else you will find that it is you that is 
asleep. It is best to back-track your last 
two movements, north to the circular 
room and then whichever way it was 
to gel back to Ihe passage lhat 
originally lead yau into the circular 
room. Then come back again straight 
away to the dungeon. That will take 
lour moves by which time the guard 
should be in the land of nod. 

You can then search him and 
rescue the princess. But your quest is 
not finished because vou must still get 
back lo the Cave ot Ice. And of course 
you musl negotiate thai circular room 
and set of passage-ways correctly 

unfriendly ogre! You should eventually 
end up back in the large hall with 
princess Zora. However, Balzan is 
waiting for you and fires a deadly 
beam right in your direction. You 
should find a way to shield Iclue) 
yoursell and reflect his beam straight 



back so he hits himself. 

You will then be able to open ihe 
chest and grab hold ot your tindings. 
You may also find that a landle will lie 
of use when you go south. Once you 
are in the room you should look 
around once again to recognise where 







and then do what they do in all the 






around o 


ce again and then with the 


candle r 




staircase lh.il you have just unt overt*! 1. 


If you da 


not take the candle with you 




xidbve adventurer! 


You I 


ill find yourself trapped, 




d by a silver door to the 




iv what else have you found 








mination of the door you are 


told that 


only those who know the 


password 


can open it. So just type in 




was written on the particular 




stage two and hey presto the 



door should swing open so make you 
escape. Now you will finally find 
yourself miraculously transposed back 
to the Cave of Ice which you were told 
holds the key to completion of the 
game, (ce and snow cover the roof but 
just try examining the root .1 bit further 
and something may jusl uncover itself! 
I will not tell you what to do here. II is 
sufficient to say thai there is a cord 
and you have a knife that has not been 
used yet. Recover ihe crown and the 
give your magic ring a rub. You will be 
whisked away and now that you have 
/oia with you. the adventure has been 
successful and is complete Well 

Next month I shall provide vou 

inKirmalion regarding Kron anil its 
many locations and puzzles some 
more difficult to solve than otners JS 
this article has hopefully shown! This 
will allow you to complete Kron very 
easily and relatively quickly so until 
then - have fun adventuring!! 
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GAMES LIST 
c r ;.e q t o r 

Keep a record of all your games disks with this versatile and novel utility 



Games I i-i Creator is a utility that 
enables you it> keep a MCOfd of all 
your names disk-., which when run 
will display your lists in a pleating 

program is simplu.lv itselt as n.i 
knowledge of machine code 
programming is neccessary. First of all 
take a blank formatted disk and copy 
the program GAMELIST CREATOR 
from the CDU disk. Load and run the. 
GAMELIST CREATOR program which 
will then present you with the main 
menu screen. There are four options 
on the menu which are; 

2. Add to an old list 

3. Create a new scrolling message 

4. Run games list 

Option 1 is the first one that you will 
have to use. lOptions 2 and 4 will not 
work unless you have already used 



11. 



First of all to create a new list take 
option I . When activated you will be 
displayed a message telling you to 
type "Q" when finished. Remember 
this. Press any key to continue with 
your choice. Displayed in the top left 
corner is an asterisk, this is now your 
cursor. Below is a message asking you 
to enter the title of a game, then a 
message saying how many games you 
have entered and finally a message 
informing you of the option you are 
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in. To t-nler a game title simply type 
the name anil press return to Store the 
name >n memory Repeat this 
operation until all your titles are 
entered. Once finished, type "Q" and 
you are then ready to save your list to 
disk for future recall. First of all, any 
old "Games Lists" are wiped and your 
new list is saved to disk. 

Consider you have now just 
purchased a few more new games 
and you want to add them to your list. 

Games List program and select option 
2 from the main menu. Entering the 
new names is the same as for option 
1. Please note that whilst using 
options I and 2 any characters except 
# and S can be used. A game title can 
be up to 29 characters long. The 
program allows for 14K for the list, 
which should be sufficient for over 
1 000 titles. 

CREATE NEW SCROLLING 
MESSAGE 

In the bottom border the program 
incorporates a scrolling message. 
What this message is, is entirely up to 
you. When you take this option, you 
will first be asked the question Size of 
space 0-51? This means how much 
space you want between each word 



on the message. It is recommended 
that 2 or 3 Is chosen. You will now 
see the asterisk at the top left of the 
screen and the message "End here", at 
the bottom left. Type in your message 
using the keys A-Z only. Do not press 
the return key until you have finished 
typing in your message. Do not worry 
about the words splitting or appearing 
to be joined up. The program 
incorporates a word wrap facility. 
Once the program has read your 
message and stored it on disk, press 
any key to continue. 

RUN GAMES LIST 

Now for the big one, your list is up to 
date, you have created a nice witty 
message and you now want to see it 
all in action. Option 4 of the main 
menu will enable you to do this. The 
program will display a list of 2 files 
which will needed to be loaded, press 
any key to start the load. When they 
have finished loading any key will run 
the games list. When run you will be 
faced with a static screen, this is for 
people wilh cartridges that wish to 
freeze out the program. The static 
screen drops a little hint that it is 
waiting for you to press fire on your 
joystick. So insert your joystick into 
Port 2 and press fire. Once you have 
viewed a screen press fire for the next 
screen. Have fun!! 

Typing "EXIT" will return you to 



ON THE DISK 



DUAL DISKCOPY 



At last, an Intelligent Twin Single drive disk copier is provided for those luckily enough to have 
more than one disk drive 



Oh no! not another disk coypying 
program (yawn). Lei it be said at ihe 
outset thai this particular disk copier 
does not pretend to be so marvellous 
as to make all other disk copying 
utilities obsolete overnight, but I hope 
you will find it different enough to be 
equally useful where the occasion 
demands. 

Disk copying utilities come in 
many forms. Some may be provided 
as part of a word processor or other 
software package for making backups, 
or they can be short Basic programs 
with a little machine code support as 
can be found for instance in the book 
"Anatomy of the 1 541 Disk Drive", or 
they can be 'turbo' backup cartridges, 
or provided as part of an alternative 
operating system such as CEOS. They 
each have their own merits. Ceos can 
copy individual files or a whole disk 
very fast; the simple Basic program 

use! if somewhat slower. 

There are a few anomalies with 
the majority of copiers in that 
invariably, for example, the copy ends 
up as a complete exact relica of the 
original, because the copy has been 
made exactly the same, that is to say 
sector for sector. This means that, due 
to much re-saving, modifying and 
extendinf of your files, some of these 
have consequently become 'spread 
about' the disk because there are no 
more 'local' sectors free. Because of 
this fact, your copy will be in the 
same mess as your original. It would 
be nice if one could make a tidied-up 
version instead, each file saved to Ihe 
copy individually, and not as part of a 
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mish mash pattern of blocks. Perhaps 
t'ven the d'rettory entries can be re 
cj-gani'j'd in a More utterly manner 

Secondly, there is the irksome 
busmen of disk swapping, though it 
you have only one drive you have no 
choice. But if you have two, some 
copiers still insist on the disks being 
swapped as they only have the other 
option of copying to the back of the 
same disk with a double sided drive 
teg. Superscript). Ceos will copy from 
device B to 9 and vice versa but not 
without the first problem mentioned 
above. And of course, many copiers 
formal the destination disk as new as a 
matter ol course, in order to be able to 
put down this duplicate image pattern, 
as naturally it is not expected that 
there may be any existing files on the 
destination disk to be preserved. If 
there are, these will disappear. But 
then some copiers cannot format the 
disk themselves, just lo add to the 
confusion. So what if you just want la 
add the contents of disk A to those 
already existing on formatted disk B? 
Copy each file individually? A process 
that can become very ledious to say 
the least. 

Suffice to say then that lo put an 

"Intelligent Twin Single Disk Drive 
Copier" was created, It is 'Intelligent' 
in that Ihe program tries lo cope with 
any probable complications thai 
might arise in ihe copying process, 

won't read properly, or the deslinalion 
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course, it the destination cufiy hasi 
been property finished off. you can t 
even atcess the information that has 
been saved onto it so far Also, as a 
further aid to the poor human 
operator, Diskcopier does not require 
endless disk swapping, as two 
seperate drives are used. Therefore, 
having got Diskcopier on its way you 
can then leave it to get on with It, 
Another variation on a theme, then, 
which I'm sure you will find a useful 
addition to your armoury of uitlity 
programs. 

To start, BOTH disk drives must be 
ON, and one of these must ALREADY 
be configured as device 9. The 
program is loaded from device 8 by 
LOAD"DISKCOPV.BAS",8,1 or select 
"DISKCOPY" from the main CDU 
menu. The screen fills up with rubbish 
from the top down and then a little 
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appear. Below this is the message 
'Drive a: = device 8 - drive b: = 
device 9 - Insert Source Disk in Drive 
a: and Destination Disk in Drive b; 
Key RETURN when ready". This being 
done, keying RETURN brings you to 
the selection from a direcloy list stage. 

Diskcopier does not copy sector 
by sector, but file by file using a list of 
filenames from the directory of the 
source disk. The message is "Enter 
directory mask 'S' followed by 
wildcards and/or filetype 

identifiers 'p/s/u' as necessary." Below 
this the first required symbol, '$', is 
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INPUT from the keyboard, followed 
by a flashing cursor. You can press 
RETURN and Diskcopier will assume 
rhat you want everythin, lie. '$') to be 
copied from the source disk in the 
order that it appears in the directory. 
Alternatively, you can re-organise the 
file entries for the destination disk 



idrn-ifu 



/ildci 

. ilemp" ti 



mple, 



etype 



inly produce ■* ''"J ill h' 
beginning lemp . nl any iilt'lype Or. 
itemp*=p' will only produce the 
Him' but whuh are PRC (programs- 
(>r yen, null) (opv all p«Ogrjms first 
with t* = p . thrn when Diskcopier 
has finished with these, rerun it to 
copy all the 5EQ tiles with '$•=$', and 
then again for anything else, which 
can be done wilh just f again. 

This last is possible because, after 
you've written a directory mask, 
Diskcopier loads in the directory from 
drive a: according to (he mask. This is 
also listed on the screen so that you 
can see what you're going lo get, in 
the usual directory format. If you 
didn'l quite gel what you wanted it is 
possible to abort Diskcopier with 



HUN/STOP RESTORE (but do it 
i|uu kl) i. and lo re-aart it with 'r'. 

After listing the directory, another 
message appears, "Overwrite any 
duplicate files (y/n)r", and you jusi 
key 'y' or 'n' as appropriate. It is (his 
feature that makes it possible to copy 
a select group ol files first, and then 
anylhing else otherwise left out by 
universal mask '$'. because keying 'n' 
to preserve files with duplicate names 
causes Diskcopier to ignore the flies 
it's already put on the destination disk, 
and instead go directly to the nest. It 
also provided the means of protecting 

already has files to which those from 
drive a: are being added, just in case 
there are any with identical names. 
The default is 'n', so even just keying 
RETURN for this last query will ensure 
the safe option of no over-writing. 

From this point on, Diskcopier 
requires no more human intervention, 
so after a hard day's programming or 

[)isk( opier lo make your bar kup copy 
while you go away and have your tea. 
(It might be prudent though to hang 
around a minute to ensure that the 



;t stage is completed without any 
hes). 

Because the very next thing that 
kcopier will do is to initialise (he 



n disk Idri 



[ b), ' 



causes (he disks ID and BAM lo be 
read by the DOS. If this fails then 
either there is no disk in the drive, in 
which case Diskcopier is gnin.n lo gel 

straight out of the bos and so is 
unformated. If a disk is unformatted 
then Diskcopier formats (he disk as 



if (he disk is formatted, (he destination 
disk is tested. 

If ihe destination disk initialised 
ok, then Diskcopier assumes that at 
least the directory track can be read 
from and written to alright, and hence 
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and e 



adja. 
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formatted, a check is made on the two 
opposite extremes of the available 
disk surface, ie: tracks I and 35. All 
sectors of track 1 are test loaded into a 
DOS buffer, and then similarly all 
sectors of track 35. If there were no 
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problems (hen il would be fair to say 
thai the disk If a healthy disk in drive 
b:. If any of these tests fail then, 
inslead of reformatting the destination 
disk to make good - a definate no-no, 
since it may have valuable data on it 

Diskcopier throws up this quaint fatal 
error message in lurid [jink; "Serious 
problem with destination disk. 
Operations aborted, unsafe to 
continue. Replace or reformat disk in 
drive b: before re-attempting copy" 

If however everything's gone 
according to plan, then the files will 
be copied one at a time, in sequence 
using the directory list. At the 
commencement of each file a line 
appears on screen. "Copying 
,i:<iilename>", and below this a line 
of blue dots should appear. The 
appearance of each dot signals ihe 
HICCM>M transfer of one equivalent 
sector full of data. I said that 
Diskcopier does not copy sector by 
sector, but for convenience il still 
transfers data in 254 byte chunks, 

too slow, the very last chunk may not 
make up a complete 254 byte, so just 
those remaining to the end are sent. 
This display of blue dots is included 
as a diagnostic aid: if the display 
freezes then a drive has hung-up and 
has to be reset. Each dot should 
appear after an interval of around one 
second - any faster means that either 
drive a: is not reading or drive b; is 
not writing, in which case Diskcopier 
must be stopped with RUN/STOP 
RESTORE and restarted from the 
beginning. If this still doesn't work 
Ihen the drives must be reset and re- 
configured, and the whole process 
restarted from scratch. 

A screen display builds up of the 
filenames copied with lheir adjacent 
sector count (in groups of blue dots), 
which is useful for verifying the file 
sizes. One or two problems can occur 
here. If some part of the source file 
won't read properly, Diskcopier abors 
further attempts and announces, 
"Can't read a:<filename>, going to 
nest item". However, everything tIiji! 
has been successfully lifted so far IS 
saved to the destination, and the 



destination lile is t loseil properly. Von 
structured partial copy. 



Whether or not the pre\ 


ous file 


copied completely, the neM 


ill 'name 


is extracted from ihe list 


nd this 


copied nest, and so on. T 


e other 


serious error is where il is d 


i . hVLTL lI 


that the destination disk is 


not that 


good after all (both dr 




continually quizzed for e 




which case we get the pink 




problem" message again, 


Mid Ihe 


program stops. BUT, whatever state 


something on it lhal is retrie 





The last problem that can occur is 
thai the destination disk become lull 
up, because the files that have just 
been tunslerred to it may not all be all 
the it has in total. (Possibly had some 
files on it already I. This generates Ihe 
"Disk full" message, and then 
Diskcopier erases the file it just tried to 
save but which didn't lit, and ends. 

when making a good copy from a 
lousy "dodgy disk ", with misaligned 
tracks, corrupted sectors, scratches or 
whatever Diskcopier won't be put off 
until it has at least attempted to read 
and transfer something from every 
single file, however long it takes. The 
ratty source disk may put up a vailanl 
resistance. blN Diskiopier won t give 
in without a considerable struggle. 
Vou cannot quarantee lhal such 
copies will be perfect, but at least you 
may have something that can be 



rescued. 

At the very end, Diskcopier 
generates a report list of any files thai 
proved impossible to read from sourc e 
completely. The lisl i aters lor up to a 
maximum of ten filenames with read 
problems, which I would have 
thoughl was quite enough. This is so 
that if you've been away, you will 

incomplete on the destination disk 
Anv eleventh and above problem life*, 
are ignored since the list is already 
full. But if there were no read 
problems you will never see the 
repori message "Incompletely 
copied:-" and the list. 

Generally Ihe time taken to copy a 
disk is proportional lo the amount of 
data transferred. A completely full 
source disk should take around 
twenty minutes, and correspondingk 

specifically selected directory list. The 
standard DOS read/write techniques 
are retaind, if a bit slow, for relijliililv. 
For the reason Diskcopier is 
independent as far as is practicable, 
so lhal while it is copying a disk you 

And finally, you can update 
backups of 'working' disks through 
the 'y' option of the "Overwrite any 
duplicate files" query prompt. 
Diskcopier always erases duplicate 
files on Ihe destination first, then saves 

opposed to using the less than ideal 
"61: ~ command. 
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Musicians amongst us will be delighted with this MIDI sequencer for the humble C64 



sequencer progrs 



simple MIDI data 
which v. 
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■ilh the 'Datel h. 



eight of boxi 
sequences, each with up to eight informatk 
tracks, to be recorded and then the progr 
played back either singly (sequence 
mode}, or in a user-set sequence (song 
mode), In song mode, i! is possible to 
play back up to t) sequences, each of 
which may be repeated several 



containing different 
1 about the current state of 
m. These are the General 

ind Control boxes. 



t provided It 



e easy to follow 



Track edit facilit 
allow simple i 

track-timing a 
also provided. 

Screen diplays 
and certain features available through 
the function keys are displayed along 
the bottom of the screen. The status of 
any track in the currently selected 
sequence is displayed through a set of 
track-status indicators. 

It is possible to 
sequences or complete sequence 
groups (songs! to disk. Disk c dldluriui 

available. Sequences, and each o 
theii tracks, may be given names an< 
a MIDI channel re-direclion l',n ilitv i 
included. 

The program generates an interna 
clock with reonrdiiifi resolutions of ."!■ 

or 48 puiscs |m mmm mm ;ppqn 



Info, Sequence 
Clock/Song Info 

The bottom line on tne screen 
displays 4 possible operations 
accessible via the four function keys. 
A further B options are available when 
the SHIFT or COMMODORE keys are 
held down (tour options each). On 
pressing either COMMODORE or 
5HIFT keys you will see the bottom 
line change to display new options. 
Above this, there is a blank line which 
is used at various times to display 
informatior 
keyboard 



rcqufS 

t. This 



STATUS/REQUEST line. 

CLOCK/SONG INDICATOR BOX 

In (he middle of the screen (well, 
almost) you will see the 
CLOCK/SONG indicator box. Rather 
(han counting time, this clock counts 
musical intervals based on a 4/4 time 
signature (4 beats to the bar, beat on 
quarter notel. The rightmost pair of 
digits count the number of PPQN, the 
middle pair count the number of beats 
(1/4 notes) and the leftmost three 
count (he number of measures (bars). 
There would appear (o be rwo clocks 
in this box, but one is the sequence 
end indicator which simply shows at 
which measure and beat the current 
sequence ends on tin other words, the 
length of the sequence). As the clock 
counts up, a metronome click will 



y be s 



throufjn mt' MIDI OUT terminal alnn; 
with normal channel data. I h. 
interna 1 > loc k may be by passed arv 
timing information ni nui) thr 
the MIDI IN terminal thus alk 



o be synchronised 



il equipment 
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sound through the TV/Monitor 
speaker on each beat. The click on 
the first beat in the measure will 
sound higher than the rest. 

This box also shows information 
relating to the organisation of 
sequences in a chain (song). The 
numbers along the lop and the arrow 
below show the current position in 
the Ming llhe 5EQ song pointer - not 
to be confused with the MIDI song 
pointer). This may be moved by 
pressing the up-arrow key. In order to 
make up a song, you must first assign 

positions. You do this by holding 
down the CTRL key ami pressing one 
of keys 1 thru 8. A number will 
appear in the space below the song 
pointer. This is the sequence number 
for that song position. Keep pressing 
CTRL <number> until the desired 
sequence number is shown. If a dash 

assigned. You may assign the 
sequence numbers in any order, as 
many times as you like up to the limit 
of 8 sequences, and since each 
sequence may be repeated up In 8 
limes, the potential for fairly long 
musiral sequences exists, limited only 
by the memory of the machine. 

In order to play the sang, you must 
put the program into SONG mode by 
pressing Ihe M key. You cannot record 
MIDI data in song mode and ihc-ic-luie 
the RECORD function is disabled. The 
song is started by pressing the PLAY 
key (Space Bar! and will continue 
until the SPACE BAR is pressed again. 
Should the External Clock Source 
option be selected, pressing ihe STOP 
key on ihe external source will hall 
the song. 

CONTROL BOX 

Above the status line, you will see the 
control indicator box. The controls 
here are analogous to a tape recorder 
with PLAY, RECORD, FAST- 
FORWARD, REWIND, STOP and 
PAUSE, The SPACE BAR alone 
functions as the PLAY key, but when 
pressed along with the SHIFT key 
(effectively the RECORD key), the 
program will begin recording. In 
RECORD or PLAY mode, the SPACE 
BAR acts as the STOP key. Whatever 



mode is in operation, the control 
indicators will reflect Ihe current 
status. If you have just loaded 
SEQUENCER E.4, the STOP indicator 
will be ■Ml'. Assuming you have 
connected up your equipment, hold 
down ihe SHIFT key and press the 
SPACE BAR. The RECORD and PLAY 
indicators will light up and the clock 
indicator will ix-gin lo fount. If this is 
the first track in a sequence, recording 
will continue until the STOP key 
(SPACE BAR) is pressed. The clock 
end indicator will be set and any 
further recordings will continue until 
the clock reaches this point. 

SEQUENCE INFORMATION 

The SEQUENCE information box is 
located in the top-centre area and is 
composed of two columns. The first of 
these is Ihe sequence number column 
containing eight numbers 
corresponding to eight sequences. 
The CURRENT SEQUENCE is shown 
by the highlighted number in this 

i hosen using I he SI IITTED < (previous 

keys. The TRACK informal ion box will 
be updated lo reflect Ihe status of the 
tracks in the selected sequence. 
Alongside each number, there is a 
nine-character space tor the sequence 
name. You may enter a sequence 
name by holding down Ihe 
COMMODORE key and pressing F3. 
You will be prompted on the request 

followed by RETURN. The name will 
then appear alongside Ihe current 
sequence number. 

TRACK INFORMATION 

The TRACK information box is 
located towards the lop-right of Ihe 
screen. There are four columns labled 
NAME, £ (track number), STATE and 
MC. In the track number column, one 
of Ihe numbers will be highlighted 
This indicates Ihe CURRENT TRACK; 
i.e. Ihe ttack in which daia will be 
recorded, should record mode be 
.11 rivaled. You may change Ihe current 
track using the unshifted > (next track) 
and < (previous track) keys. 

Each track may be given a name of 
up to 4 characters in length. The 



name is displayed alongside the 
number of the track in the NAME 
column. To name a track, move the 
current track indicator to the required 
position, hold down the 
COMMODORE key and press Fl . You 
will be prompted on the request line 
lo enter up to 4 characters, followed 
by RETURN. The string will then 
appear in (he NAME column. 

The track STATE column reflects 
the current status of each track in the 
current sequence. A track with no 
data in il will show CLEAR. A track 
with data in it normally shows ST BY 
(standby). In record mode the current 
track shows "REC* (record). In play 
mode, a track will show PLAY> unless 
it has been muled in which case it 
will show MUTED. This system allows 
you to see what any track in the 
sequenc e is ibing al any lime. 

The MC, for MIDI CHANNELI 
column shows which channel Ihe 
data shall be outpui on (regardless of 
which channel it was recorded on). If 
no number is displayed, the data will 
be output as it was recorded, 
otherwise it will be outpui on the 
indicated channel. You may change 
the channel by holding down the 
SHIFT key and pressing the key (1-8) 
relating to the track number. 

GENERAL INFORMATION 

The GENERAL information box is 
kxated down the left-hand side of ihe 
screen and is further divided into a 



number of 




TEMPO indie 


Hoi displays ihe current 




k speed in Beats-Per- 


Minute (ba 


sed on a 4/4 time 


signature). In 


dally, this is set to 120 


beals-per-min 


ite. This may be altered 


using Ihe + and - keys lo increase and 


decrease thi 


numher respectively. 


The range i 


20 to 200 beats-per- 



Below this, we have the PPQN 
indicator inlitially set to 24. You may 
change this using key F5 (Set PPQN). 
PPQN may be set to 24 or 4B. The 
higher this number the grealer the 
recording resolution. After pressing 
F5, the status line shows a number of 
options for the PPQN value; Fl 
selects 24, F3 selects 48 and F7 exits 
without changing the value. On 
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INFO boK description of the MC this to lesl a MIDI network, 
controls). 

COUNT, or Count In mode is toggled 

SYNC, or MIDI SYNC is toggled using using the I key. When activated, a 

the S key. When activated, START, record session will be preceeded by a 

STOP and MIDI CLOCK data is sent two-measure count in before 

out over the MIDI OUT terminal at a recording actually begins. Any data 

rate of 24 clocks- per-quarter- note. You received during ihis time is still 

cannot activate SYNC when using an recorded and thus program control 

external clock source. changes may be sent to SEQUENCER 

64 before play actually begins. You 

STEP mode Is activated land will hear the metronome click during 

deactivated) using the O key. When count-in through the TV/Monitor 

activated, the status line requests key speaker, 
input for the step interval which may 

be 1/4, 1/B, 1/16 or 1/32 note, tkeys SONG (song model is toggled using the 

F1, F3, F5 and F7). When in step M key. When active, song mode allows 

mode, the clock will stop after the up to eight sequences to be played in a 

chosen interval and you must press predefined order which is set up in the 

RETURN to allow it to advance. Press CLOCK/SONG box described earlier. In 

O again to turn step mode off. song mode, the RECORD function is 
disabled and you must switch song 

CAPTV, or Captive Play Through, mode off to record more data, 
when activated [using the P key! 

allows data in the MIDI IN terminal to INTCK/EXTCK. This indicates the 



Clock Source option, use a PPQN 
value corresponding to the clock rate 

Next, we have the Memory 
Indicator which reflects the remaining 
amount of free memory. When this 
falls below 50 bytes, recording is not 
possible and some data must be 
cleared before recording may 
proceed. Below the memory 

repeat indicator. This shows how 
many times the current sequence will 
play during playback. This is a value 
from 1 to 9 or * linfinate). You may 
alter this value for the current 
sequence using the ' key. Below this 
we have the function indicator area. 
The corresponding "light" will be 'lit' 
when a function is activated. The 
various functions are described 
below. 

XTHRLJ , or record playthrough is 
toggled using the X key. When in 
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current clock source. The internal 
clock is probably ju urale enough (or 
most applications but there may be a 
need to sync the computer with an 
outside source. Toggle the clock mode 
using the C key. In INTCK mode, all 
data received is recorded, including 
MIDI clock and 5TOP/START DATA! 
In EXTCK mode. MIDI clock, START 
and STOP data is NOT recorded and 
is used to synchronise the computer 
with the rest of the system. 

THE TRACK EOITOR 

The SEQ Track editor allows you to 
nwkr .ilk" at ions to data stored in the 
current track. When you enter the 
Track Edit screen, the data contained 
in the current track is moved lu hrfih 



management is performed when this 
happens and there may be a delay 
when most of the memory arena is 

After recording MIDI data in a 
track, hold down the SHIFT key and 
press the E key. The Track edit screen 
will appear. MIDI events are listed in 
four columns; Event Time, Event Type, 
MIDI Channel (channel messages- 
onlyl and Event Data. At the outside 
edges of the display area, there are 
two ariows which indicate the current 
event. To move the pointer, press the 
CURSOR DOWN key or SHIFTED 
CURSOR UP. The screen will scroll 
up or down as required. 

Along the bottom of the screen 
you will see the functions available 
through pressing the appropriate 
function keys; MODIFY, DELETE, 
INSERT and EXIT. A CTRL-E keystroke 
will exit without saving any changes 
made Tin-*' uperaums take efleit at 
the current pointer position For 
example, pressing the DELETE option 
removes the current event from the 
screen When INSERT hi pressed, a 
MIDI event list is : i . ■ i Simply 
press the appropriate key for the type 
of event that you want to insert The 
new event will he .nwrted nto the list 
at the current position and may now 
be modified. 

The MODIFY option allows you to 



aller any part of Ihe current evenl. 
After pWWing Fl.. a highlighted (ursor 
appears and may be moved between 
columns by using the CURSOR 
RIGHT key or SHIFTED CURSOR 
RIGHT key. The data in the current 
column may be altered using the + 
and - keys. You may then leave 
MODIFY by pressing the RETURN 

If the event type is a NOTE ON or 
NOTE OFF, Ihe first data value is 
shown as a musical note; e.g. C4 14th 
octave O. Otherwise, the data shown 
is a .1-digil decimal number, a NOTE 
ON event with a velocity value of 
mo will be shown as a NOTE OFF 
bul should the velocity value he 
altered to be non-zero then the event 
will be shown as NOTE ON. 



FUNCTION KEYS - (UNSHIFTED) 

Fl - Disk Directory 

fl - Disk Command 

F5 - Set PPQN value 

f7 - Auto-Correct Current Track 

FUNCTION KEYS - (SHIFTED) 
Fl - Save Sequence to disk 
F3 - Load Sequence from disk 
F5 - Save entire song to disk 
F7 - Load entire song from disk 

FUNCTION KEYS - (COMMODORE 
KEY) 

Fl - Name track 



SWITCH CONTROL KEYS 

M - Change murle N in^eque nee : 

C - Clock source (intck/extck) 

P - Captive playthrough 
X - Record playthrough 

S - Sync data output 
O - Step mode 

TAPE TRANSPORT CONTROLS 
Cursor Right - Fastforward (1 beat 

steps) 

Cursor Down - Rewind II beat steps! 
Cursor Left - Fastforward ( 1 pulse 

steps) 



Cursor Up - Rewind U pulse 

stepsl 
SPACEBAR - Play 
SHIFT/SPACE - Record (current 

track) 

HOME - Rewind to start of 

SEQUENCE/TRACK CONTROLS 

+ - Increase tempo 

- Decrease tempo 
1 thru 8 - Mute/Unmule Irack 
(also works in play) 
SHIFTlthrufl - Change current track 

MIDI channel 
CTRL I thru fl - Assign sequence to 

song position 
* - Alter sequente repeal 

A - Aller song pointer 

< - Select previous track 

as current 
> - Select next track as 



SHIFT < 
SHIFT > 



Cursor Down 
Cursor Up 



Cursor Right 
Cursor Left 

fl 
F5 



- Select previoi 



- Enter track editor 

R CONTROLS 

- Abort (don't save 
changes) 

- 5elect next event as 
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Join & Insulate 




Joystick Wire 

I 



Figure 2a 



Figure 2b 



be displayed, if nol then recheck 
your wiring. If all is working then this 

shown in figure 4. or some similar 
place. 

Version 3 of Security. SEC V3.00, 
' identical to version 2 except for 



addit 



urn the 



information onto 
if your mother i< 
computer off as s 
red light burninj 
have a blank formatted disk ready 
and insert it into the drive as soon as 
the program is loaded. If a pressure 
pad is depressed or the door is 
opened or closed, the time and 



rlplic 



ill be 



'Close door to slop alarm' will be 
displayed in the centre of the screen. 
Plug the wire in PORT I, the screen 
should continue to flash. If it does 
not flash then the black and brown 
wires must be touching. If the screen 
was flashing then press the pressure 
pad or louch the roil pieces lujst'ther. 
the screen should now stop flashing. 
If it does not stop, then check the 
wiring and also check that the plug is 
in Port 1. If all is correct and the 
flashing stops then the nest stage is 

excellent place for both pressure pad 
and foil, see figure 3. For the wire to 
reach you might have to extend it. If 
you are lucky enough to have games 
good enough to break two joysticks 
Ihen the second version, SEC V2.0D, 
can also be used. 

Remove the pressure pad as 
before and rut the wire as close to 
the joystick as possible then trim the 
seven core wire so that only BLACK 
and ORANGE are exposed, instead 
of BLACK and 8ROWN. |oin the 
bare wires to the pressure pad as 
shown in figure 2. Load the program 
SEC V2.00 from the menu. Enter the 
time when prompted, plug in your 
first wire Ithe wire joined to the 

door. If all is correct the screen will 

display 'door shut. Scanning ' now 

plug the new wire into Port 2 and 
depn.-v, the pari. ,i ni(".H.ige 'pressure 
pad depressed at HHMMSS' should 




Figure 3 



Pressure Pad 



Figure 4 
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ON THE DISK 



BOOT! 

Single key loading with autorunning for both Basic and 
Machine Code programs is provided for with this smart utility 



Superboot! creates a short math 
autoboot prugram that will I 
execute a Basic ot Machir 
program automatically from 
load command, just like 

program. BUT THAT'S NOT ALL. The default "I 



BARRY GRAHAM 

Superboot! then asks you to choose a 
boot symbol. Enter a symbol of your 
>r press RETURN to accept the 



n lo.icl and c 



chosen bee 



and running your main program. II you 
have a disk lurboloader that loads into 
high memory, your boot program will 
load and ailivale the turbo before speed 
loading and running your main 
program. All with just one load 

I ovrim.rnd 



?, before loading located next to the quote mark on the 



keyboard. Change this symbol if you 
wish. After you enter the symbol the 
name of your autoboot file is displayed. 

You will then be asked lo enter the 
SYS address to start your main program. 
Il your main program is machine code 
enter this address as a decimal number. 



The key to the operation of Press RETURN if the main program is 



in Basic. Superb *>i' j 
[l.isic programs w ' 



s that 



t distinguishes the autoboot address of Basic (normally 20491. If you 



program. 

from your main program and can oe 
used to load and execute a machine 
code program named "!" before the 
main pn luram loads. 

If you copy J turboloarter hi disk and 
in turboload and 

programs i 



want your Basic program to load 
some other address, you must aller the 
location of Basic with the appropriate 
pokes before auti il» < iling vixjr | «< «;i,im. program 

Next you will be asked to enter the 
SYS address to activate the first loaded 



HOW THE AUTOBOOT WORKS 

Most autoboots depend on the same 
principle. The program loads low in 
memory and overwrites a key address 
used by the operating system. In this case 
it is the Basic warm start vector at 
locations $0302-50301. When the load 
is complete the system performs a warm 
start and jumps lo the new aridrss which 
is the start of the machine code routine 
contained in the autoboot. If the first load 
option has been requested, the routing 
first loads a machine code program with 
a single character name malchingthe first 
character in the autoboot name. A jump 
is performed to the SYS address of the 
first program. On return, the Basic 
Lommand "NEW" is executed to alkiw a 
further lend The main program is then 
loaded, the original wami start vector is 
reinstated and the end address of the 
loaded program is stored. If the main 
program is Basic, the operating system is 
pointed to the start of the program. The 
command "CLR" is performed and the 
program lines are rechained in case the 
program has been relocated. The boot 
program then jumps to Basic and the 



,. 11 the n 



III pr-iij:r,im I- 



i the disk by creating dual program. Ithe first load is always 



another symbol. "+" for example, lor RETURN if you do not requir 



a firs 



toboot files that load i 
program or "#" for autoboots that preload 
and activate a graphics utility called ~#" 
before autobooting your main program. 
Do not use the symbols @, " or '., as these 
have a special meaning to DOS. 



program to be loaded. If no SYS address 
is entered the autoboot will load only 
your main program. If you only want to 
load the first program without executing 
it; enter 138 as the SYS address, this is a 
direct return used by the operating 
system. Note that the first load must be 
saved on the same disk as your main 
program and be renamed with a one 
character name that matches your boot 
symbol. This program does not have to 
be a turbo, any machine code routine 
can be loaded and activated before your 
main program auloboots. 



CREATING AN AUTOBOOT 

Place the disk that contains the main 
program you wish to boot in the disk 
drive. The autoboot must be saved lo the 
same disk. When Superboot! is run, you 
will be asked to enter the name of the 
main program. This should he the name 
of the final program that the autoboot 

will load. Superbool! automatically adds Supertxiot! assembles and 
a boot symbol to the front of this 
filename when the autoboot is saved, sc 
the name of your main program I: 
limited to fifteen characters, Tht 
program tests this and will print an erroi 
message if the length is exceeded 
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machine code, a jump lo the SY5 address 
is performed after the load end address is 

RESTRICTIONS 

There are a few precautions that should 
be observed: 

The main program to be loaded can 
be either Basic or machine code, bul the 
filename must not be more than fifteen 
i lui.n tt-rs in length. 

Your first load program is optional but 
musl be written in machine code if you 
use on. Enter a SYS address of 1 38 for the 
program lo load only without executing. 



The n 



sin pr< ii'.r.im 



loado 



mpk-l^ 

machine code autoboot program to disk 
which contains the load options you 
requested. The drive status message 
should indicate a successful save and 
instructions for autobooting your 
pniuum are printed <>n ihe screen. 



load unless this is inleriliun.il. 
NEVER load a main program over a 
turbo loader. Programs that load over 
locations 502A7-50303 cannot be loaded 
by the autoboot. (They autoboot anyway). 
Relocate Basic manually before 
autobooting a Basic program that does not 
load at the normal star! ot Basic ISDBUI ). 
Remember to copy your first loaded 
program to the same disk as your autoboot 
and main program, then rename it with 
the first character ot your aulobooL 



FEATURE 



CBM Development 
Assembler 

Commodores own assembler development package is put under the microscope and some 
of the bugs ironed out. 



GEOS environmenl while others have 

covered the C128 for the Cb4. I 
beleive (he best value for money is 



oblcr 



fulles 

[hi- | 

standard ol Commodore doiu- 
mentaiion which is poor, and the rest 
is caused by a tew minor bugs! (Note; 
These are the views of the author of 
this article and not necessarily those 
iir tin- marine.. Ed!!) 

I have heard a number of 
complaints from people about not 
being to use the macro facility and 
this set me thinking. I have been using 
macros on this assembler lor about 3 
years without any problems, so why 
didn't they work for others? The 

■ cirlipldiilts. Hill i:n-irlp, spei it'll . made 

it difficult to comment. Recently 



MIKE GREGORY ° nce *?- u > 't has CDm e. le,ed 

to its .END. the file is closed and input 
is redirected to come from the original 

In-line basis with a louse dcl'inilic 
for a 'line' being a'l the text Irom a 
carnage relum (u the next Thi*. is |usl in Paw I. the macro iwm and its Had 
as you would expect. A line has arc road into a ram disk This needs 10 
generally !hc following lormat; occur before any (alls to the macro 

are made When a t a'l is then made it 
- input to COtne Irom this ram 



where the bracket* are used to 
iridic .ill: lidds whit h ma\ be optional. 
This again is not new information, the 
point I wish to stress however is that 
the fields must be seperated. 
Normally at least one 'space' is used 
to separate fields, but if the 
programme! uses more than one, to 
improve on screen format, these are 
accepted, but ignored, by the parser 

Lines of lexl are read Irom a file 
and the file used is dependent upon 
the Assembler's directives (ihe 'dol' 
commands). Assembly starts by using 
,i designated disk source file supplied 
if the 



s part 



process is directly comparable with 
the .LIB directive except that a new 
file does not have to be opened. Since 
the macro text is stored more-or-less 

unnecessary spaces, macros ban be 
inspected at $8800 in ram after an 
assembly run. This address is correct 
for my version of the Assembler. It 
starts with the message 'CBM 
RESIDENT ASSEMBLER VD9D282'. 
The storage formal is as follows: 



mpts. If a FIL directive is 
ed in this file, the file is 
I then re-opened using the 



l is only put on hold. It is 
but, instead, a second file 
ind reading continues from 
le. Thjis is the reason that 
l have a . LIB withing a .LIB, 
have too many files open. 



BYTES 1-6 

BYTES 7-fl 

BYTES 9-10 
BYTES 11-12 
BYTES 12-14 
BYTES 15-16 
BYTES 1 7-1 8 



BYTES 19-20 pointerlo 

BYTES 21-22 pointerlo 

BYTES 23-24 pointer to 

BYTES 25-26 pointerlo 

BYTES 27+ text of ma 
LAST BYTE-1 
LAST BYTE 



macro name padded 

with spaces 

pointer to start of next 



l"" n ' 



hlgnk lir 
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show that fields are separated by a 
single space and thai lines end in a 

with an opcode, an extra space is 
added to produce an indent. As is 
normal, all of the pointers .ire j;iven in 
low byle/high byte format. For the 
parameter values the storage format is 

parameter does nut exist, its pointer is 
$0000. Also since the internal 
symbol s. labels (ft -19) are filled out. 
whilst being read m during pass 1, the 
same ITMCro CM produce ditlerent 
expanded COda deiiending upon the 
Mippffed paramelets' More on ihis 
liter. One nl^er point worth 

recognised bv ihe parser by being a 
label having an assigned value of 
SFFFF. This means that you cannot 
have a label at this address. 

Now on to the bugs themselves. 
Here's a short macro, called PAUSE, 



given in the menu to demonstrate 
BUG 2. The following macro is 
supposed to allocate storage space; 



;BUG 2 DEMO 

MAC DECL ; declared storage 

M .WOR0 

•-•+{2 
,MND 



1000 



that should c 



inly to demonstate BUG T. 



1080 .MND 

1090 ; 

1100 '=SC000 
1110 PAUSE 
1120 .END 

You'll find it hard to believe that this 
simple piece of code produces so 
many errors during assembly! Try it. 

You should get one -non- 
alphanumeric' error and four 
'undefined symbol' errors. Do the 
assembly without entering an object 
filename, lat the first prompt just enter 
CR), to speed things up. I'll supply a 
better fix later, but can you note for 
now that if line 1 1 1 0 is changed to; 

1110 PAUSE ;call macro 
then assembly proceeds without 
error! Also, if the internal label 'IV is 
changed lo ''.2', then the problem 



1090 .END 

Again, you will find that it will not 
assemble. This time we are given a 

message. Unfortunately there is now 
simple fix along the lines given above 
for this bug. We must do a little 
patching. 

Before fixing these problems it is a 
worthwhile exercise to examine their 
causes. A hex memory dump for the 

assemble BUG 1 demo shows the 
following; 



B80A 00 00 
8B0C 00 00 
OTOE 00 00 et( 



However it is obvious that the text is 
merely the roreward pointer to the start 
of the next macro! The clues given 
eariier allow us lo deduc e thai the bug 
only involves '.\ and does not occur if 
text is given on the same line as the 
macro call. The following code 
fragment relates lo pan of the macro 
handler (see fig. II. 

I am not sure thai my commenls for 
lines #2C0f-$2Cl 8 are correct, however 
it is somewhat irrelevenl since Irorti ihe 
discussion above we should exrxi I ihe 
same outcome it nu riles exists alter the 

The code above shows that the only 
tlitierenee between the two situations is 
that lines S2C0f-S2C18 are executed if 
the macro call is commented or if 
parameters are supplied, but not 
otherwise. The actual bug oc curs by 
h.ivinij im orrec I entry condition^ fur the 
subroutine at $2C87. We can correct 
this by re-order I ng the lines; 

2C0A AD 78 09 LDA J097B 

2C0D 8D 80 09 STA $0980 

2C1 0 AD 79 09 LDA $0979 

2C13 8D 81 09 STA $0981 

2C1620D1 IS |SR$15D1 

2C19 9015 BCCJ2C30 

A simpler alternative wtxild appear to be; 
2C0D 90 24 BCC $2C33 
which cuts out the subroutine call 
entirely when there is nu field ti >lli iv\ ing 
the macro call. The effect of BUG 2 can 
be seen by examing the macro storage 
area at $8800 after assembling the 
demo. A mermxy dump is as follows; 



Observant readers lalll will immediately 
recognise the 'H' which appeared in the 
assembly listing. The character 
corresponding to $88 is unprintable and 
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2BF9 A9 01 
2BFB20CE 1C 
2BF3 AO 11 
2CIK) A9 00 
2C02 91 10 
2C04 8B 
2C05 10 FB 
2C07 BD 82 09 
2C0A20D1 IS 
2C0D9O21 
2C0F AD 79 09 
2C12 BD 80 09 
2C15 AD 79 09 
2C18 8DB1 09 
2C1B 20 4F 2C 
2C1E9O10 
2C20 C9 2C 
2C22 FO 06 
2C24 20 F1 29 
2C27 4C 1B2C 
2C2A 20 87 2 C 
2C2D+C 1B2C 
2C30 20 87 2C 
2C33 60 



LDA #10 
ISR S2CCE 
LDY #$11 
LDA #$00 
STA($10I,V 
DEY 



ISR SI 5111 
BCC S2C30 
LDA 10978 
STA S09B0 
LDA S0979 
5TA S09B1 
ISR $2C4F 
BCC S2C30 
CMP #S2C 



; ptnmmt pom 



BFQS. 

ISR $; 



IMPJ2C1B 
ISR S2CB7 
IMP I2C1B 
ISR S2CB7 



been picked up. The remainder of this 
particular macro seems In tie ok. The 
values for the parameters are also ok. 
The following code fragment is the 
part of Ihe parser routine [hat reads 
Ihe macro defination inlo the ram disk 
macro storage during pass 1 (Fig. 2). 

The start of the bus 15 fairly obvious. 
The routine at S2AC3 to store the 
character oughl to be saving (he full 
stup which Indlcmd Ihe assembler 
directive. The accumulator has 
however been overwritten by 
preserving the storage pointers! This 
part of the problem can be fined by 
using Ihe Y index register fo preserve 

2AB7 AC 76 09 LDY $0976 

2A8A BC 7C 09 STY S097C 

2ABD AC 77 09 LDY $0977 

2ACU BC 7D 09 STY S097D 

The rest of the problem is at S2ADD 
where, if the first character after the 
full stop is not an 'M', since Y is zero 
the remainder ol tin: lino is ignored! 
This is fixed by redirec ling Ihe branch 
at S2AAB so as to continue reading 
the same file; 

2ADDO0C9 BNE S2AB1 



If all of the above corrections are 
made, both demo macros should 
assemble without errors and a few 
usolul mar ros i an now be developed. 
I will now show you how macros are 
coded and will also demonstrate 
some olher features ot Ihe Assembler 
Package which are either not well 
dm indented or are not known. 

USING THE CBM MACRO 
ASSEMBLER 

Earlier in this article I showed how Ihe 
bugs in Ihe CBM Macro Assembler 
r ould be fixed. If you have made the 
necessary corrections to the code we 
can now proceed to develop and use 
the macro facility. It is a feature well 
worth using because of its 
eileitiveness in jllowing your coding 
to be developed as modules. 

library. I would strongly urge you to 
build up a similar file of your own. 
The label names are generally the 
same as those used in published 
books such as the Programmers 
Reference Guide or the Complete 
Commodore Inner Space Anthology It 
should give ready access to common 
entry points used in the Basic and 
Kernal ROMs Notice that, since the 
file is to be used as a library and will 



be called by the .LIB directive, it 
finishes with a .END. 



1000 .-listing 1 

1010 equates 

102U ;Mike Gregory |uly 1989 

1030 i 

1040 CRLF-S0D 

1050 CLS=S9E 

1070 ; 

1080 sBASIC ROM P.OUTINE5 

109(1 STROUT=SABIE 

1100 LINPRT=$BDCD 

1110 ; 

1 1 20 > KERNAL ROM ROUTINES 

1130 5ETLF5=SFFHA 

1140 SETNAM=SFFBD 

1150 OPEN=$FFC0 

1160 CLOSE=SFFC3 

1170 CHKIN=$FFC& 

11B0 CLRCHN=$FFCC 

1190 CHRIN=$FFCF 

1200 PLOT=$FFF0 

1210 ; 

1130 .END 



The routines listed are described in 
most machine language text books so 
I will not dwell on (hem here. Lines 
1 0B0 and 1 1 20, which start with a V 
symblol may lie ol interest. They are a 
form of hidden comment. The lines 
will list from the Editor but will not 
appear in the assembly listing! 

Seven macros are supplied in 
listing 2. Macro 1 and Macro 4, I have 
indicated how to use condilional 
assembly feature. The conditional 
directives are IFE and .IFN which 

not equal to zero' respectively. Both 
refer to the expression in the field 
immediately following the directive. 
Note that the field is separated by at 
least one space. The condiiinn.il lexl 
must appear within the '<' and '>' 
symbols. They are easy to remember 
if you see them as a pair of stylised 
braces. The opening symhol is the first 
field after the expression and on the 
same line whereas (he closing symbol 
is placed al the end of the text as the 
first symtjol on a new line. The effect 
of conditional assembly in the first 
macro is that the code will only be 
generated if the program counter ("I is 
at the slarl ol basic IS0801I when the 
macro is called. That Is when 
■=$0801 is zero. Macro 4 is more 
complex. Depending on whether or 
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2AA3 AB FF 
2AA5 BE 6E OB 
2AAB20 3F2B 
2AAB 90 E6 
2AAD C9 2E 
2AAF FO 06 
2AB1 20CA29 
2AB4 4C A8 2A 
2AB7 AD 76 09 
2 ABA BD 7C 09 
2ABD AD 77 09 
2AC0 BD 7D 09 
2 AC 3 20 CA 29 
2AC6 AD 00 
2ACB 20 3F 2B 
2ACB 90 C6 
2ACD 8D 7E 09 
2ADG 20 CA 29 
2AD3 AD 7E 09 
2AD6 D9 66 20 
2AD9 FO 22 
2ADB CO 01 
2ADD DO B4 
2AOF C9 41 
2AE1 DOCS 
2AE3 20 3F 2B 
2AE6 90AB 
2AE8 C9 43 
2AEA DO C5 
2AEC AD 7A 09 
2AEF BD 76 09 
2AF2 AD 7B 09 
2AF5 8D 77 09 
2AfB A9 26 
2AFA 4C 47 2C 
2AFD CB 



I. DA S04"" 

STA $097D 
JSR 129CA 



CPV #S01 
BNE I2A93 
CMP #$41 
BNE S2AAB 
JSR S2B3F 
BCC S2A93 
CMP #$43 
BNES2AB) 
LDA S097A 
STA S0976 
LDA $0978 
STA $0977 
LDA #$26 
JMP $2C47 



CPYS! 



5! fur MND 
; not MND 



: get next char 
esIlfC 

*anch if not C 



nol a zero is supplied as parameter 4 
(?4I, different code is produced! H 
should be stressed however that in 
order for this to work, if a label is lo 
be used for the name address, then 
the label must be defined before the 
macro is called. Puf simply, the 
assembler needs to know during Pass 
1 which code section will be 
generated otherwise the counter 
which is used to assign values to 
labels will gel lost. Macro 6 
demonstrates how to call a macro 
iroin within a mac 



Oi 



tiling a 



ijii1cn-.it 
t is thai 



important general 
ihf ^up|jliL-d parameters . 
by commas. Do not use spaces in 
them to sepearte them. The handler 
code at S2BF9 takes a space to be the 



; LISTING 2 
1010 : MACROS 
,MIKE 



1040 : MACRO 1 TO CREATE 
BASIC LINE 
; CALL - BASIC 
1060 ; 

1070 .MAC BASIC 

.IFE -=$0801 <wly 
assemble if at $0801 
1090 .WORD M, 10 
0 .BYTE 

SYS,'206r,0.10,sys2061 
10 (1.WORD0 



1130 .MND 



1150 


■ MACRO 2 TO PRINT 




MESSAGE ON SCREEN 


1160 


CALL -PROMPT ADDRESS 


OF TEXT 








.MAC PROMPT 






1 '(H) 


LDY #>i1 




ISR STROUT 






1230 






; MACRO 3 TO GET STRING 


FROM 


INPUT DEV 


1250 


.■CALL • STRIN STORAGE 




ADDR, ALLOWED LENGTH 








.MAC STRIN 








il |5R CHRIN ; gel char 




CMP 4CRLF 




BEQ )4 




STAil+l.Y 


1310 






CPY«2 


1350 


BCC?3 




(4 STY M ,-save length received 












;MACRO 4 TO OPEN FILE 




:CALL - FOP EN 




NUMBER,DEV,5EC,NAME 




ADDR 


1410 




1420 


!mac FOPEN 




LDA#(1 








LDY 4(3 














1490 


LDA #0 




|SR SETNAM 




|SR OPEN 


1520 








ISM 


IFN ?4 <;a5semble if name 










1570 


LDY #>J4 


1580 


ISR SETNAM 


1 /.'■<! 1 


ISR OPEN 


i6i n 




U.I 11 




1620 


.MND 


1630 




1640 


.MACRO 5 TO CLOSE FILE 


1 650 


.-CALL - FCLOSE NUMBER 


1670 


.MAC FCLOSE 


N.BU 


LDA »?1 


1690 


ISR CLOSE 


1 700 


.MND 
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1710 
1720 


;MACRO 6 TO READ DISK 


FKKO 


CHANNEL 


1730 


;CALL - FERROR ERROR 




BUFFER 


1740 




1750 


.MAC FERROR 


1760 


FOPEN 15,EI,15.0ropen channel 


1770 


LDX «1 5 


1780 


ISR CH KIN, 'make Input fife 


1790 


STRIN >),40;read message lo 


buffer 




1800 


LDA #CRLF 


1B10 


STA (1 


1820 


STAiT+1,Y 


1 830 








in"! 


5TAM+1,Y 


I860 


FCL05E15:ctosefl[e 


1870 


PROMPT M ;print message 




.MND 


1890 




1900 


;MACRO 7 TO POSITION 




CURSOR 


1910 


.■CALL - 5URSET XP05.YP05 


1910 


,MAC CURSET 


1940 


CLC 


1 950 


LDY #11 


l %(> 


LDX »f"2 


1970 


|SR PLOT 


1980 


.MND 


1990 




2000 .END 


Listing 


3 puis il all logelher in a short 


pragn 




1000 


.listing 3 


101 c 


program lo demonslrate macros 


1020 


rmikc Gregory july 1989 


lOio 




1040 


.OPT NOLIST 


1050 


.LIB LISTING 1 


1060 


.LIB LISTING 2 


1070 


.OPT LIST 


1080 
1090 


•=•0801 


1100 


BASICrun start 


11 111 




1120 


IMP CODE;climb ow storage 


1130 




1140 


ADDR .BYTE 0 


1150 


.WORD 


1160 


INBUFF .BYTE 0 


1170 


•-5+40 


1180 
1190 


CODE PROMPT TEXT;ask (or input 


1200 


STRIN INBUFf,16;gel input 


1210 


CURSET0,12;aboutmidscreen 



1220 


FOPEN2,8,2,INBUFF;open file 


1230 


LDX #2 


1240 


JSRCHKTN;make file input 


1250 


STRIN ADDR,2;read two bytes 


1260 


FCLOSE2;close file 


1270 


FERROR INBUFF;read error 




channel 


1280 


|SR CLRCHN;restore normal i/o 




LDA INBUFF+1 


1300 


ORA INBUFF+2 


1310 


CMP #'0' 


1320 


BNE EXIT.no address if fife error 


1330 


LDA ADDR+2 


1340 


LDX ADDR+1;convert hex lodec 


1350 


|SR LINPRT;and print 


1360 


EXIT RTS 


1370 
1380 


TEXT .BYT CLS.CRLF, THIS 




ROUTINE' 


1390 


.BYTE 'WILL DETERMINE THE' 


1400 


.BYTE 'LOAD' ,CRLF,' ADDRESS 




OF' 


1410 


.BYTE 'A PROGRAM'.CRLF, 




CRLF 


1420 


.BYTE 'PLEASE ENTER FILE 




NAME'.O 


1430 




1440 


.END 


The u 


se of the .OPT directive in lines 



1040 and 1070 is worth mentioning. 
You may not always want Ihe full list of 
equates or all Ihe macros printed in the 
assembly listing. This is how the listing 
is switched off. Also Ihe default settings 
will cause the macros not to be 
expanded in the assembly listing. Only 
the macro call will be printed. This is 
sufficient lor macros which have been 
ir it'll and tested but during development 
an expansion of the code is often 
requited. This expansion is switched on 
and off by the GENERATE and 
NOGENERATE options as is; 

.OPT GEN 
or .OPT NOG 

Remember thai ihis i lass of directive 
can be used in combination; 

.OPT LIST.GEN 
or .OPT NOL.NOG 

One other assembler bug that come to 
mind from listing 3 is thai you should 
never add a comment field on the same 
line as either a .FIL or LIB directive. The 



error! I have a fix for this, but ihe 

renders wishini; in n> it ihemselveds will 
find Ihe relevanl code ai $1180. You 
should consider what happens when a 
'space' occurs after the filename. This 
piece of rode also prevents the use of 
filenames whit li have spaces in them! 

Listing 4 is a short demo for how the 
Assembler will produce different coding 
depending upon the form of the 
supplied | i,i ra meters. Again the code is 
not intended to do anything other than 
demolish ate the point. It should be 
remembered that (he parameter texl is 
supplied verbatim to Ihe parser routines. 



10QO;lisung4 
1010;demo 

1020 ;mike gregory july 1989 
1030; 

1040 .MAC MULTI 
1 050 LDA (1 
1 0bO .MND 

1070: 

1 080 ;NOW TEST IT 
1 090 .OPT GEN 
1100 R6510=$01 
1110 "=$2000 

1120; 

1 1 30 MULTI HO.'immediate 

1 1 40 MULTI 128;ieropage 

11 50 MULTI 256;absolule 

1160 MULTI LAB EL;fllMO lute 

1170 MULTI #>R6510;immediate high 

1180 MULTI #<LABEL;immediaie low 

byte 
1190; 

1 200 LABEL -BYTE 0 

1210; 

1230 .END 



The assembly listing will show the 
different tiNles which are generated. 

I hope you find this article of some 
use and value. Its purpost is not to 
provide a program thai finds a file load 
address but lo demonslrate what can be 
done with the CBM Assembler, and, in 
particular with macros. It should show 
that quite complex programs can be 
developed speedily by using a good, 
sound macro library, The ability to get 
an idea up and running quickly often 
helps bo maintain the initial enthusiasm. 
Once it is running, the code can be 
optimised for memory space or for 
execution speed if required. 
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Our resident agony aunt sifts through more of your technical queries. 

thai people need to knt 



Deaf CDU, 
I am considering buying an Amiga 
500 but wish to know if I can use it 
with my Commodore 1902 colour 
monitor which I currently use with a 
C12BD. The 1902 has composite 
video, RGB and RF sockets and so I 
guess lhat al least one of these 
would be compatible with the 
Amiga. However, I am not sure if 
the resolution would be as good as 
the new 1084 monitor used with the 

R.I.Cranton, Somerset. 



>r the A 



not to produce a decent image or 
your particular monitor. It must allow 
an analog RGB display and have ; 
separate connection for the audit 
output, unless of course you plan ti 
link it with a stereo system. If there k 
any difference in resolution then 
can only think that it would be si 
slight as to be unnoticeable. 



Dear CDU, 

excellent Hi-Res Demo Kit by Neil 
Higgins (Jul/Aug 1989) and the 
subsequent plea for help in the 
February edition of Techno Info. The 
disk contained a program which 
creates a file that then loads the 
demo created, and also loads and 
executes a BASIC program once the 
spacebar has been pressed. The 
utility works well with the original 
demo contained on the disk which 
has been compacted - it does nol 
however work with any demo 
created in its original formal. Also 
could you please tell me how to use 
character sets crealed by Font 
Factory 89 in my own programs 
once they have been saved to disk. 



Perhaps it would be worth having a 
program support section where ynu 
give details or hints on how results 
can be best achieved when using 
CDU such as how to incorporate the 
utilities for your own use. 

I.Mullen, Coatbridge. 

Dear Mr.Mullen, 

Thanks for pointing this error out - I 

apologise to Scott Malhieson who 
originally requested the program and 
to all other readers who have tried 
this out. Hopefully this sort of thing 
will never happen again. Now that 
grovelling is over, how to rectify the 

(hanging one number and is related 
to the machine code starting address 
of the demo. The compacted one 
had a start address of 2080 and 
normal ones use 2115. Therefore, 
load the program PROB1 from the 
disk and then list line number 215. 
Change the first part so lhat the data 
reads: 215 DATA 0,32,213,255, 
32,67,8,... It is the &7 that is 
different. Then save it back to the 
CDU disk. With regard to Font 
Factory you should arid the following 
lines to the start of your program: 1 
A=A+1: IF A=1 THEN LOAD 
-filename", 8,1 and then to enable 
the new set include a line like 2 
POKE 53272,28 in your program. I 
think that telling ihe users how to 
particular progr 



I fully 
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elf. The v 



purpose of the instructions in his 
contribution text is to not only reveal 
how to use the program, but also 
how to incorporate things created by 
it in your own programs. Therefore, if 

anything please remember that not 
everyone knows everything about 
your program and so it is quite 
important lhat you cover every detail 



program support M-dion, that is part 
of the service that Techno Info offers. 
Should anyone, like yourself, have a 
query about any program lhat CDU 
has published I hen simply drop us a 
line at the address given at the end. 
Thanks once again for pointing out 



Dear CDU, 

With my CM, 1541 and MPN801 I 
use Precision Softwares Superscript 
wordprotewir for < orrespondence. 
To improve printing quality and 
produce Norwegian letters l bought 
an Olymuid FSWItmlK dai>ywhrrl 
printer >aid to be compatible with 
the Cb4. I rannol. howevpr. find 
anyone to tell me how lo make Ihe 
tSWIOOOC print from the word- 
proces>ing program. Having 
discovered your magazine recently I 
hope lhat you can advise me. 

Knut Sjovorr, Orpington. 

Dear Knut, 

Unfortunately the only thing that I 
can suggest is that, with Superscript 
and printer manuals in hand, you go 
very carefully through the defaults 
file that is supplied with the word- 
processor and change everything 
relevant according to what your 



pnnl 



il states 



I sorts of things and is the only w; 
that I can think of that the prograi 
can be configured to your printe 
Sorry that I cannot be of any moi 



Dear CDU, 

First of all many thanks for a very 
good disk magazine. The next reason 
for writing is to ask for some help. I 
have a C12B, 1571 disk drive and 
the MPS1200P printer and as you 
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can imagine I am really pleased to 
see the C12B programs. Bui I 3m 
really fed up this month (|une). I have 
tried every way possible to load Ihem 
but Ihey will still not load. Is it me, I 
have tested the compuler and it loads 
other programs without problems, 
but the program POPP and CUB 
Converter/Maths Aid will not load. I 
would be most grateful uf any help. 
David Taylo 



Dear David. 

I can safely say that it is not you that is 
at fault, unless you are not using the 
DLOAD command. You do not 
mention what the problem with 
loading is but I suspect that you gel a 
file not found error. This is not 
uncommon. A lot of 128/1571 setups 
produce Ihe same result and I have 
found that it is due lo ihe tiles being 
individually write -protected, thai is - 
having a less than sign after the tile 
type in the directory Von must use a 
dish editor to remove ihn proles turn ■ 
.t is a simple matter ol changing a 
hylc but most d.retio'y ni, tors have a 
facility lo urtpmiei I a die 
Alternatively use the program I 
supplied with my Direi lories 
ExB'ainnl atic le n the February : 990 
issue If thai does nor work then the 



the file < 



) the lop ol the 



Dear CDU, 

I have a C128 and 1571 and a 1901 
monitor but this months disk (|une) 
seems not to work correctly. I was 
able to get Ihe games working but the 
programs thai i wanled - no wav 
Alealory Music was still announcing 
thai it was loading code after an 
hour. Afler attempting In load Ihe 
Personal Organiser Cage Printer in 
bvlh 1541 and 1371 modes .ill | got 
was a file nnl found error, the ( I 28 
Converter/ Ma I hs Aid did load 
successfully but Ihen I was faced with 
a blank screen for an hour. I would 
be very grateful if you could point 
out where Ihe errors lie, whether 
with my limited experience or with 
the programming. 

W.Nisbel, Plymouth. 



Dear Mr.Nisbet, 

There were no errors with ihe 
software and I cannol see why 
Aleatory Music and CI 28 
Converter/Maths Aid did not work. 
Possibly with ihe lalter your monitor 
was not in eighly column mode 
although I presume thai you tried 
lhat. The problem with POPP and 

described in the previous letter. If 
you (and Mr.Taylorl would like lo 
relurn your disk lo me at Techno Inlo 
then I shall have a load lo see what I 
can do in Ihe way of reclilying any 
problems. Please mark your package 
REQUESTED. 



sprite should appear. Perhaps Ihe 
fault is in using the wrung pointer 



' the 
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Dear CDU, 

In Ihe |une 1990 issue of CDU yoo 
presunled Iwn programs on the disk 
which I found especially useful - 
Sprite Generator 2 and Sprite Ba»ic. 
Although I have been ahlp tn use 
bolh programs separately, when 
using Sprite Basic I have not 
managed In load a sprite definilion 
produced bv using Sprite Ceneralnt 
I. I would be mosl graleful if vou 
could please tell me whal is wrong 
and supply a routine whiih would 
solve my problem. I hanking you in 
antic ipaliun uf vnur assistance 

Alexander Sendler. Bedford. 

Dear Alexander, 

II is possible to load and operate 
Sprite Basic and then lo load and 
use a sprite created with Sprite 
Generator. 1, so I can only assume 
that you are doing sumi'thing wrong. 
Therefore I shall just go over the 
procedure toad Sp-ite Cent-raior 2 
and treale your shapes The" sase 
Ihem to a disk remembering lust to 
reset the drive if vou 'oaded the 
program from Ihe menu Then 
swiii h everything on and oad Sprite 
Etasii Again, if loaded from the 
menu you should 'esei ihe drive 
When you have initialised Sprite 
Basic load the sprite data 
remembering ihe .0,1 suffix. Then 
use the relevant commands - 5PRXY, 
SPRAT, SPKSLOT and SPRITE (m that 
order) - lo display Ihe sprite. Make 
sure you follow very carefully the 



Generator i. Sprite Basic requires 
lhal a sprite has a pointer islol) value 
thai is over Si hut also preferably 
over 128. That means that if, when 
you save ihe data tmm Ihe generator 
program, you are giving values of 
less than 12000 or more lhan S41XX1 
then ynu are using the wrong areas. 
Also ensure thai the pointer value on 
Ihe edilling screen is 128 or more 
($80 in hex). Other lhan that I can 
provide no more help. I hope you 
will be able lo gel il lo work now. 



Dear CDU, 

W'ilh reference lo the CDU April 
1990 Te.hno Info, yuu published a 
letler from a person named Smart 
Smith of Manchester who asked 
whether it is possible lo have an 
eighlv column display on a C64. 
Actually il IS possible In Ihe Vnur 
Commodore magazine of lanua.y 
1988 Ihere is a lisling of a program 
lo have I his facility. The program 
IW 'be graphu bitmap si rem and 
BASIC 



ther 



used at a lime and vou have less 
memory. The screen memory map 
for inslance is twice as large as 
usual. When I program (in BASIC) I 
have a little problem with REM 
statements. It is that I cannol lype 
shifted letters in REM statements. 
For example, typing 10 REM (shift) 
C (shift) B (shift! M only results in 
10 REM LEN PEEK FOR when Ihe 
program is listed. Why can I not use 
shifted letters in REM statements 
and why arc Ihey replaced by 
BASIC keywords' How can this 
problem be rectified? Thirdly, I am 
going to buy a printer but I am nol 
sure which one lo buy. I am 
interested in Ihe Commodore 
version of Ihe Star LC-10. Is it fully 
compatible with the C64 and its 
software, or is it better to buy an 
MPSI200 or Cilizen I 20D printer; 
Also, is it worth buying the colour 
version and if so Is it compatible 
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with PrinrPk that you published in 
the February issue? I will use it 
mainly for word -processing but also 
lor program listings and dumping 
graphic screens. Finally, with regard 
to PrintPic, and although I do nol 
own a printer, I think thai if people 
load a Koala File picture and then 
select the Trilogic option for 
printing, everything will still work. If 
this does work then owners of the 
excellent Advanced OCP Art Studio 
drawing package can also use 
PrintPic by converting their files 
using the program TECHNO INFO 
that was fealured on the April 1990 
disk. That program converts from 
OCP to Koala File format. Please let 
me know if the above really does 
work and with what type of printers 
it works. Also could you kindly 
answer the other questions that I 
have asked in this rather long letter. 
Ludwig Flask, Malta. 

Dear Ludwig, 

Thankyou very much for your letter 
all the way from Malta. On your first 



the same theory lo REM 
you will be able to have the shifted 
characters. Place one (and only one) 



I mm 



.1 going K 



sible 



whether or not the Star LC-10, or 
any other printer lor that matter, will 
be ( ompalible with every piece of 
software that has heen or will be 
produced. Most things, though, work 
fine. Whether lo choose a Star over 
an MPS or a Citi/en must be decided 
by you. It is best to gel a 
demonstration of each and make op 
your mind from there. The Slar LC- 
on) is compatible 



*ith F 



I poin 



poin 1 



mid a 



y that I DID (ell Stuart that it 
was possible ■ using the bitmap 

programming techniques are far too. 
complex for me to explain it here 
because for a start all outputs (o the 

rerouted to a routine to calculate the 

characters, and screen editting also 
becomes very difficult to tackle. If 
you would kindly forward me a 
photocopy of the program listing or 
a disk containing the program then I 
will forward it on to Stuart. The 
reason for the keywords appearing is 
because all BA5IC programs are 
tokenised/encoded using shifted 
land some other) characters for the 
keywords. Therefore when you list 
the program with these characters in 
the REM statements they are 
decoded to the keywords that they 
represent. To overcome the problem 
you must put the computer in quote 
mode. That is the reason for having 
to enclose any DATA that contains 
non-alphanumeric characters within 
quolation marks. Simply hy applying 



ribbon printers). In theory it works 
hecause when PrintPic is operated 
the picture appears with all colours 
correct (except background ■ change 
with Fll. I can therefore see no 
reason why it would not work. 
Could somebody please try this out 
(using a Koala File or OCP converted 
picture with PrintPicI for us and tell 
us what happens. Be careful with the 

obtain the reversed spade symbol 
use the Commodore key and one. I 
hope I have been of assistance. 



Dear CDU, 

I have been trying for a number of 
weeks to sell my MPSfiOl printer that 
is in immaculate condition but 
everyone around where I live either 

printer. So it may be slow and a little 
noisy in comparison to todays 
printers but at only forty pounds 
(which includes postage! you would 
think people would be clammering 
for it. It is fitted with a special chip to 
provide true descenders and three 
olher fonts although the switch for 
this needs slight attention - a bit of 
soldering that I could do myself if 
someone asked nicely. I really cannot 
understand how anyone without a 
printer, so long as you do not want it 
for really professional things, could 
afford not to buy it. It will even 
support GEOS and dumps graphic 
screens with ease. Please, Techno 
Info, could you help me. 
Jason Finch, somewhere in England, 

Dear |ason, 

Well I certainly cannot understand 
why no-one wants it. Who really 
cares if it is unidirectional because if 
something does its job I say grab it 
before somebody else dues. I, myself, 
find it very difficult to resist the 
temptation. If anyone does want to 
buy this superb printer then please get 
in touch with us at the address below. 
You never know, lason may even 
accept a tiny bit less depending upon 
how quick you ask for il. I wish you 



Thai about wraps il up (or ihis issue because Tip of the Month is on hold 
until the September issue. I wanted to provide you with a little program but 
Ihe big Mr E (alias Paul Evesl reiused lo grant me any disk space because I 
was a little late and there was lhat big hoo-har with CDU and a certain 
publisher so I did not know whether I was coming or going! And none of 
you wonderful people have sent me any tips so I could hardly include one 
oi those. How many limes do I have to ask for a Tip ol the Month from one 
ol you before someone obligesfr? li you do want lo share your knowledge 
with us, or if you have any programming problem or query, (hen please do 
not hesilale to drop us a line at the NEW Techno Info address: CDU 
Techno Info, 1 1 Cook Close, Brownsover, Rugby, Warwickshire, C\ 
I NG. Please note that this is only the address for Techno Info. All olher 
correspondence and contributions should be sent to the other .iddress 
the magarine which will probably be printed elsewhere in (his issue, 
until nest month - gel thinking, get wriling. and have fun! 
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SOFTWARE OFFER!! 



For ihisc readers th.it h.ivc missed 
out on previous issues of CDU, we 
are providing special compilation 
disks of a numher of programs thai 
have appeared on ihe disks in the 
past. The disks each cover J specific 
topic, ip 5ound/Musii programming. 
Machine code programming. Basic 
programming etc etc. The firsl two of 
these new compilation disks are 
available now. Disk number 1 is a 
Machine Code special and Disk 
numher 2 is devoted to General 
Utilities. 

To obtain the disks, simply (ill out 
the coupon below and send with your 
remittance to the address as stated. 




This disk is made up ut the following 



491 ^2. This is ber.mse you may w.ml 
to use the area ai memory where the 
monitor is actually located. There are 
a total of 10 commands available to 
the user. This is a good monitor for 
those that are not too experienced in 
machine code, 

LOCATION FINDER. It gels pretty 
Uning looking through objccl code to 
find out just which page 2ero 
locations it's messing up. Take ihe 
legwork olil of it with this simple 
program. Location finder simply tells 
you which memory locations a piece 
of object code is using, including 
those all important zero page 
locations. The information it provides 

incorporate a piece of object code 
into your awn programs. 

ZMON. We tend to get over obsessed 
with 6510 programming, forgetting 
that lurking inside our CI Jfl's there is 
a perfectly good ZHO mt roprocessor 
Zmon makes this processor available 

Monitor. No longer is it necessary to 
import a machine-specific operating 
system like CP/M to try out the Z80. 
lusl prefix vour MONITOR command 
with 'Z' and ZMON will 
automatically invoke the Z80 to carry 



LINK and CRUNCH. Once a machine 
code program has been written it 
often occupies several diliereni ,ne,is 

use the space as efficiently as it could. 
The LINKER and CRUNCHER have 
heen devised to help you correel ihis 
and save the need for Basic loaders. 

PSVMON. Psymon is a machine code 
monitor program for use with the 
C64. There are two versions, one 
located at J68B4 and the other at 



DISK TURBO. Disk Turbo, once 
installed, should speed up your disk 
saves and loads by a factor ol around 
ten limes. The only limitation to the 
program is that it allows fot a 
maximum program of lay block 
programs to be Turboloaded, 
however, this should not present too 
many problems. 

6510+ ASSEMBLER. Use this 
assembler once and you may never 
need another aid to writing machine 



code programs. This assembler is a 
valuable aid both for writing 
professional machine code programs 
and (or learning atioul programming. 
It is a three pass assembler which 
allows the use of labels and contains 

production of code by permitting 
merging routines from tape or disk. 

MICKMON. Get to grips with your 
programming techniques wilh Ihis 
powerful Machine Language Monitor. 
Mickmon is designed for use on a 
C64 with a 1541 or compatible disk 
drive. In addilion to monitoring the 
computers own internal state. 
MICKMON has commands that 
access the disk drives memory, and 
can even address the surface of the 
disk itself. It also has powerful extras 
not found on other monitor programs 

6510+ UNASSEMBLER. To comp- 
liment the 6510+ assembler program, 
we have provided the unassembler 
which is specific for this particular 
assembler. Once used, you will 
discover just exactly how valuable an 
un.jssc-mbler can be as part of your 
arsenal of programming utilities. An 
unassembler makes the inspection ol 
machine code programs a pleasure 
instead oi a burden, 

BAR PROMPTS. Professional looking 
menu driven programs and 
applications ran be achieved by this 
simple machine code program. All 
you are ever likely lo need lo produce 
these impressive results are contained 
in this one short program, 

SPEEDY UNASSEMBLER. Like the 
6510+ unassembler above, this 
program is specific to the 5peedy 
Assembler that has been produced by 
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Thai concludes the list of programs 
that appear on the first. Machine 
Code Special, compilation disk. 



W DISK 2 - General ^ 
1 Utilities I 

u 

This disk is made up of the following 
programs: 

DIRECTORY DESIGNER. Sort out 
your disks with this versatile and 
powerful disk utility. Typical of 

wonderful computer as the Ctrl then 
hide all it's power so that using it is, lb 



Ihe Chronological file and Categories 
files. Keeping labs on all your programs 
has never been this easy. 

DISK TOOLBOX. This program may 
well be the ultimate in disk utilities, 
lust about everything you need is here 
to give you total disk-based 
happiness. The program incorporates 
such things as A Monitor, Emended 
Basic Commands, Disk Drive Editor, 
File Copier and extensive disk based 
utilities to make life easier for the 
programmer/program developer. Not 
to be missed, 

DATA MAKER. Data maker is a useful 
machine code utility for converting 
memory locations to Data statements. 



rectified, deleted and i 
Each record can have a i 
39 fields but the record I 
not exceed 25:> characters. 



SCRAPBOOK. This program is a type 
of dalabase and as its name suggests, 
it is used rather like the scrapbook 
you omh.ibly had as a child. This may 
seem fairly unuseful, but for many 
applications it has advantages over 
Ihe traditional database organisation. 
Information is stored not as records 
with set fields, but rather as pages. 

PROGRAM COMPARE. Any Basic 



This 



of 



>ay the 
prograi 



* the 



world of Ihe Disk Drive DOS withe 
the need to cram megabytes 

knowledge into their head. Direct mode as w 

mode, provided the 
DISK LIBRARIAN. This program is best in memory, 
described as a superb disk-filing 
system, as opossed to program. In 
essence the program allows the user to 
order their files on their disks into two 
lari>e databases. These daiahases are 



■i [imgr.i 



BASE-ED. Base-Ed 

ri.n.ikisv allowing 

records per disk which may b( 
entered then subsequently viewed 



i Please send iv 



Copies Disk No. I @ £5.95 each 
Copies Disk No. 2 @ £5.95 each 
i heque/poslal order for 
J (Made payable to Alpha vik' Publications Ltd.) 

I Address 

Postcode 

3) Alphavile Publications Ltd., CDU Software Offer, 20 Potters 
<iln Farm, Milton Keynes, MKt I 3HF. 



that 
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be l 



applications. For cample, machine 
code programmers may want to 
convert their coding to a Basic loader 
for those who do not have an 
assembler. Also it could be used to 
convert sprite data, and add this as 
DATA statement at Ihe end of the 
resident Basic program, 

DEVAID. Devaid, which is short for 
Development Aid, adds no less than 
41 new commands to the resident 
C64 Basic. It gives the programmer a 
very powerful army of new 
commands to aid the development ot 
programs written in Basic. Some of 
ihe commands can be used both in 



pmgia 

headac 

whenever you modify or alter a 
Basic program. The inevitable G 
or COSUB that gets missed out 
line you delete by mistake, then I 
what it was originally etc etc 
these headaches are a thing o 
past. With this program, you 



|.M<t'.Vl 



either 



SPREADSHEET 64. A really superb 
Spreadsheet program for the C64 
written in WEOS Basic (Window 
Environment Operating System). This 
spreadsheet program will aid any 
company or household to follow the 

forecasting figures and in budgeting. 
The program is easy to use and is very 
user friendly. 



of 500 TEXTED 



ict but powerful 
igram which may meet all your 
irdpioressing needs. Texted is a 
irdproi essnr which provides mosi 
the le.ilures found on commercial 
igrams, coupled with easy icon 
ecled commands and advanced 
nter and disk interaction. 



That concludes the list ol 
the second, General Uli 
compilation disk. 

disks. Graphics progra 



prograi 
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